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ERROR CODES 


ERROR 

CODE ERROR CODE MESSAGE 

2 Memory Insufficient 

3 Value Error 

4 Too Many Variables 

5 String Length Error 

6 Out of Data Error 

7 Number greater than 32767 

8 Input Statement Error 

9 Array or String DIM Error 

10 Argument Stack Overflow 

11 Floating Point Overflow/ 

Underflow Error 

12 Line Not Found 

13 No Matching FOR Statement 

14 Line Too Long Error 

15 GOSUB or FOR Line Deleted 

16 RETURN Error 

17 Garbage Error 

18 Invalid String Character 

Note: The following are INPUT/OUTPUT er- 
rors that result during the use of disk drives, 
printers, or other accessory devices. Further in- 
formation is provided with the auxiliary hard- 


ERROR 

CODE ERROR CODE MESSAGE 

142 Serial Bus Data Frame Overrun 

143 Serial bus data frame checksum error 

144 Device done error 

145 Read after write compare error 

146 Function not implemented 

147 Insufficient RAM 

160 Drive number error 

161 Too many OPEN files 

162 Disk full 

163 Unrecoverable system data I/O error 

164 File number mismatch 

165 File name error 

166 POINT data length error 

167 File locked 

168 Command invalid 

169 Directory full 

170 File not found 

171 POINT invalid 


ware. 

19 LOAD program Too Long 

20 Device Number Larger 

21 LOAD File Error 

128 BREAK Abort 

129 IOCB 

130 Nonexistent Device 

131 IOCB Write Only 

132 Invalid Command 

133 Device or File not Open 

134 BAD IOCB Number 

135 IOCB Read Only Error 

136 EOF 

137 Truncated Record 

138 Device Timeout 

139 Device NAK 

140 Serial Bus 

141 Cursor Out of Range For explanation of Error Messages see Appendix B. 
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PREFACE 


This manual assumes the user has read the Atari BASIC — A Self-Teaching 
Guide or some other book on BASIC. This manual is not intended to “teach” 
BASIC. It is a reference guide to the commands, statements, functions, and 
special applications of Atari® BASIC. 

The programs and partial programming examples used in this manual are 
photostats of listings printed on the Atari 820™ Printer. Some of the special sym- 
bols in the Atari character set do not appear the same on the printer; e.g., the 
clear screen symbol appears as a “ }”. The examples in the text were 
chosen to illustrate a particular function — not necessarily “good” programming 
techniques. 

Each of the sections contains groups of commands, functions, or statements 
dealing with a particular aspect of Atari BASIC. For instance, Section 9 contains 
all the statements pertaining to Atari’s unique graphics capabilities. The appen- 
dices include quick references to terms, error messages, BASIC keywords, 
memory locations, and the AT ASCII character set. 

As there is no one specified application for the Atari Personal Computer System, 
this manual is directed at general applications and the general user. Appendix H 
contains programs that illustrate a few of the Atari system’s capabilities. 
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TERMINOLOGY 


GENERAL 

INFORMATION 


This section explains BASIC terminology, special notations, and abbreviations 
used in this manual, and the special keys on the ATARI 400™ and ATARI 800™ 
Personal Computer Systems keyboard. It also points to other sections where 
BASIC commands deal with specific applications. 


BASIC: Beginner’s All-purpose Symbolic Instruction Code. 


BASIC Keyword: Any reserved word “legal” in the BASIC language. May be 
used in a statement, as a command, or for any other purpose. (See Appendix A 
for a list of all “reserved words” or keywords in ATARI BASIC.) 


BASIC Statement: Usually begins with a keyword, like LET, PRINT, or 
RUN. 


Constant: A constant is a value expressed as a number rather than represented 
by a variable name. For example, in the statement X = 100, X is a variable and 
100 is a constant. (See Variable.) 


Command String: Multiple commands (or program statements) placed on the 
same numbered line separated by colons. 


Expression: An expression is any legal combination of variables, constants, 
operators, and functions used together to compute a value. Expressions can be 
either arithmetic, logical, or string. 


Function: A function is a computation built into the computer so that it can be 
called for by the user’s program. A function is NOT a statement; it is part of an 
expression. It is really a subroutine used to compute a value which is then 
“returned” to the main program when the subroutine returns. COS (Cosine), 
RND (random), FRE (unused memory space), and INT (integer) are examples of 
functions. In many cases the value is simply assigned to a variable (stored in a 
variable) for later use. In other cases it may be printed out on the screen im- 
mediately. See Section 6 for more on functions. Examples of functions as they 
might appear in programs are: 


10 PRINT RND< 8 ) 

(print out the random 
number returned) 

10 X=108+COS<45> 

(add the value re- 
returned to 100 and 
store the total in 
variable X) 


i 
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Logical Line: A logical line consists of one to three physical lines, and is ter- 
minated either by a or automatically when the maximum logical line 

limit is reached. Each numbered line in a BASIC program consists of one logical 
line when displayed on the screen. When entering a line which is longer than 
one physical line, the cursor will automatically go to the beginning of the next 

physical line when the end of the current physical line is reached. If | 

not entered, then both physical lines will be part of the same logical line. 


Operator: Operators are used in expressions. Operators include addition (+), 
subtraction (-), multiplication ( * ), division (/), exponentiation ( A \ greater than 
( », less than (<), equal to (=), greater than or equal to (>-), less than or equal to 
(< =), and not equal to (< >). The logical keywords AND, NOT and OR are also 
operators. The + and - operators can also be used as unary operators; e.g., -3. 
Do not put several unary operators in a row; e.g., 3, as the computer will in- 

terpret it incorrectly. 

Physical Line: One line of characters as displayed on a television screen. 

String: A string is a group of characters enclosed in quotation marks. 
“ABRACADABRA” is a string. So are “ATARI MAKES GREAT COMPUTERS” 
and “123456789”. A string is much like a constant, as it too, may be stored in a 
variable. A string variable is different, in that its name must end in the 
character $. For example, the string “ATARI 800” may be assigned to a variable 


called 

A$ using (optional) LET like this: 


10 

LET A$="ATARI 809" 

( note quotation marks) 


OR 


10 

A$=" ATARI 809" 

(LET is optional; the 
quotes are required.) 


Quotation marks may not be used within a string. However, the closing quota- 
tion can be omitted if it is the last character on a logical line. (See Section 7 - 

STRINGS). 

Variable: A variable is the name for a numerical or other quantity which may 
(or may not) change. Variable names may be up to 120 characters long. 
However, a variable name must start with an alphabetic letter, and may contain 
only capital letters and numerical digits. It is advisable not to use a keyword as a 
variable name or as the first part of a variable name as it may not be interpreted 
correctly. Examples of storing a value in a variable: 

LET C i 23DUB= 1 . 234 
LET UARIABLE1 12=267. 543 
LEThfI 
LETF5TH=6 . 5 
LETTHISNO = 59.883 

Note: LET is optional and may be omitted) 


Variable Name Limit: ATARI BASIC limits the user to 128 variable names.To 
bypass this problem, use individual elements of an array instead of having 
separate variable names. BASIC keeps all references to a variable which has 
been deleted from a program, and the name still remains in the variable name 
table. 
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If the screen displays an ERROR-4 (Too Many Variables) message, use the follow- 
ing procedure to make room for new variable names: 

LIST filespee 
NEW 

ENTER fileseee 

The LIST filespee writes the untokenized version of the program onto a disk or 
cassette. NEW clears the program and the table areas. The program is then re- 
entered, re-tokenized, and a new variable table is built. (The tokenized version 
is Atari BASIC’s internal format. The untokenized versions in ATASCII 
which is the version displayed on the screen). 

Arrays and Array Variables: An array is a list of places where data can be 
filed for future use. Each of these places is called an element, and the whole array 
or any element is an array variable. For example, define “Array A” as having 6 
elements. These elements are referred to by the use of subscripted variables 
such as A (2), A (3), A (4), etc. A number can be stored in each element. This 
may be accomplished element by element (using the LET statement), or as a part 
of a FOR/NEXT loop (see Chapter 8). 

Note: Never leave blanks between the element number in parentheses and the 
name of the array. 


Correct 

Incorrect 


A(23) 

A 

(23) 

ARRAYC3) 

ARRAY 

(3) 

X123(38) 

X123 

(38) 


SPECIAL 
NOTATIONS 
USED IN THIS 
MANUAL 


Line Format: The format of a line in a BASIC program includes a line number 
(abbreviated to lineno) at the beginning of the line, followed by a statement 
keyword, followed by the body of the statement and ending with a line ter- 
minator command (l;l=mj;KBkev). In an actual program, the four elements might 
look like this: 


Line Number 
100 


STATEMENT 


Keyword Body 

PRINT A/X * (Z + 4.567) 


Terminator 


RETURN 


Several statements can be typed on the same line provided they are separated by 
colons (:). See IF/THEN in Section 5, and Section 11. 


Capital Letters: In this book, denote keywords to be typed by the user in up- 
per case form exactly as they are printed in this text. Reverse-video characters 
will not work except in the case of the RUN command. Here are a few ex- 
amples: 

PRINT INPUT LIST END GOTO GOSUB FOR NEXT IF 


Lower Case Letters: In this manual, lower case letters are used to denote the 
various classes of items which may be used in a program, such as variables 
(var), expressions (exp), and the like. The abbreviations used for these classes of 
items are shown in Table 1.1. 
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Items in Brackets: Brackets, [ ], contain optional items which may be used, 
but are not required. If the item enclosed in brackets is followed by three dots 
[exp,...], it means that any number of expressions may be entered, but none are 
required. 

Items stacked vertically in braces: Items stacked vertically in braces indicate 
that any one of the stacked items may be used, but that only one at a time is per- 
missible. In the example below, type either the GOTO or the GOSUB. 


100 (gos T u°b} 2000 

Command abbreviations in headings: If a command or statement has an ab- 
breviation associated with it, the abbreviation is placed following the full name 
of the command in the heading; e.g., LET (L.). 


ABBREVIATIONS The following table explains the abbreviations used throughout this manual - 

USED IN THIS 

MANUAL TABLE 1.1 ABBREVIATIONS 

avar Arithmetic Variable: A location where a numeric value is 

stored. Variable names may be from 1 to 120 alphanumeric 
characters, but must start with an alphabetic character, and all 
alpha characters must be unreversed and upper case. 

svar String Variable: A location where a string of characters may be 

stored. The same name rules as avar apply, except that the last 
character in the variable name must be a $. String variables may 
be subscripted. See Section 7, STRINGS. 

mvar Matrix Variable: Also called a Subscripted Variable. An ele- 

ment of an array or matrix. The variable name for the array or 
matrix as a whole may be any legal variable name such as A, X, 
Y, ZIP, or K. The subscripted variable (name for the particular 
element) starts with the matrix variable, and then uses a number, 
variable, or expression in parentheses immediately following the 
array or matrix variable. For example, A(ROW), A(l), A(X + 1). 

var Variable: Any variable. May be mvar, avar, or svar. 

aop Arithmetic operator. 

lop Logical operator. 

aexp Arithmetic Expression: Generally composed of a variable, 

function, constant, or two arithmetic expressions separated by an 
arithmetic operator. 

lexp Logical Expression: Generally composed of two arithmetic or 

string expressions separated by a logical operator. Such an ex- 
pression evaluates to either a 1 (logical true) or a 0 (logical false). 

For example, the expression 1<2 evaluates to the value 1 (true) 
while the expression “LEMON” = “ORANGE” evaluates to a zero 
(false) as the two strings are not equal. 
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sexp String Expression: Can consist of a string variable, string literal 

(constant), or a function that returns a string value. 

exp Any expression, whether sexp or aexp. 

lineno Line Number: A constant that identifies a particular program 

line in a deferred mode BASIC program. Must be any integer 
from 0 through 32767. Line numbering determines the order of 
program execution. 

adata ATASCII Data: Any ATASCII character excluding commas and 

carriage returns. (See Appendix C.) 

filespec File Specification: A string expression that refers to a device 
such as the keyboard or to a disk file. It contains information on 
the type of I/O device, its number, a colon, an optional file name, 
and an optional filename extender. (See OPEN, Section 5.) 

Example Filespec: “DlrNATALIE.ED” 


OPERATING 

MODES 


Direct Mode: Uses no line numbers and executes instruction immediately after 
key is pressed. 


Deferred Mode: Uses line numbers and delays execution of instruction(s) until 
the RUN command is entered. 


Execute Mode: Sometimes called Run mode. After RUN command is entered, 
each program line is processed and executed. 

Memo Pad Mode: A non-programmable mode that allows the user to experi- 
ment with the keyboard or to leave messages on the screen. Nothing written 
while in Memo Pad mode affects the RAM-resident program. 


SPECIAL 

FUNCTION 

KEYS 



Reverse (Inverse) Video key, or “ATARI LOGO KEY”. Press- 
ing this key causes the text to be reversed on the screen (dark 
text on light background). Press key a second time to return to 
normal text. 


CAPS/LOWR 


Lower Case key: Pressing this key shifts the screen characters 
from upper case (capitals) to lower case. To restore the characters 
to upper case, press the ■■•lillia key and the ■•HDH.V.'f key 
simultaneously. 


d9 Escape key: Pressing this key causes a command to be entered 

into a program for later execution. 

Example: To clear the screen, you would enter: 


io print “ na rrm 


CLEAR 


and press 


RETURN 


Escape is also used in conjunction with other keys to print special 
graphic control characters. See Appendix F and back cover for 
the specific keys and their screen-character representations. 
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BREAK 


Break key: Pressing this key during program execution causes 
execution to stop. Execution may be resumed by typing CONT 
followed by pressing |£UUilil . 


ARITHMETIC 

OPERATORS 


LOGICAL 

OPERATORS 


SYSTEM RESET 


System Reset key: Similar to in that pressing this key 

stops program execution. Also returns the screen display to 
Graphics mode 0, clears the screen, and returns margins and 
other variables to their default values. 


SET-CLR-TAB 


Tab key: Press and theESEESDUkeys simultaneously to 

set a tab. To clear a tab, press the ESE3 and QjJBESQH keys 
simultaneously. Used alone, the advances the cursor to 
the next tab position. In Deferred mode, set and clear tabs by 
preceding the above with a line number, the command PRINT, a 
quotation mark, and press the key. 


INSERT 


Examples: 


100 PRINT 
200 PRINT 


SHIFT I SET-CLR-TAB 


SET-CLR-TAB 


Default tab settings are placed at columns 7, 15, 23, 31, and 39. 

Insert key: Press the »;naM and ■iimaa keys simultaneously to 
insert a line. To insert a single character, press the IAIM and 
■i:H3aa keys simultaneously. 


DELETE BACK S 


Delete key: Press the msium and keys simultaneously 

to dele te a line. To delete a single character, press I4W1 and 
ICT373I simultaneously. 


DELETE BACK S 


Back Space key: Pressing this key replaces the character to the 
left of the cursor with a space and moves cursor back one space. 


Clear key: Pressing this key while holding down the 

QUO key blanks the screen and puts the cursor in the upper left 
corner. 


SHIFT 


RETURN 


Return key: Terminator to indicate and end of a line of BASIC. 
Pressing this key causes a numbered line to be interpreted and 
added to a BASIC program RAM. An unnumbered line (in Direct 
mode) is interpreted and executed immediately. Any variables 
are placed in a variable table. 


The Atari Personal Computer System uses five arithmetic operators: 

+ addition (also unary plus; e.g., +5) 

- subtraction (also unary minus; e.g., - 5) 

* multiplication 
/ division 
A exponentiation 


The logical operators consists of two types: unary and binary. The unary 
operator is NOT. The binary operators are: 
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AND Logical AND 

OR Logical OR 


Examples: 

10 IF H=i 2 AND T=8 THEN PRINT "GOOD 11 

10 A=( C>1 ) AND < N< 1 ) 


Both expressions must 
be true before GOOD is 
printed. 

If both expressions 
true, A = +1; otherwise 
A = 0. 


10 A = (C+l) OR < N-l ) 


If either expression 
true, A= +1; otherwise 
A = 0. 


10 A = NOKC+l) 


If expression is false, 

A = +1; otherwise A=0. 


The rest of the binary operators are relational. 

< The first expression is less than the second expression. 

> The first expression is greater than the second. 

= The expressions are equal to each other. 

< = The first expression is less than or equal to the second. 

> = The first expression is greater than or equal to the second. 

< > The two expressions are not equal to each other. 

These operators are most frequently used in IF/THEN statements and logical 
arithmetic. 


OPERATOR 

PRECEDENCE 


Operations within the innermost set of parentheses are performed first and pro- 
ceed out to the next level. When sets of parentheses are enclosed in another set, 
they are said to be “nested”. Operations on the same nesting level are performed 
in the following order: 


Highest <, >,=,<=,>=,<-> 
precedence 


* 


/ 


<>, = ,<=,>=,< > 


Lowest 

precedence 


NOT 

AND 

OR 


Relational operators used in string expres- 
sions. Have same precedence and are per- 
formed from left to right. 

Unary minus 
Exponentiation. 

Multiplication and division have the same 
precedence level and are performed from left 
to right. 

Addition and subtraction have the same 
precedence level and are performed from left 
to right. 

Relational operations in numeric expressions 
have the same precedence level from left to 
right. 

Unary operator 
Logical AND 
Logical OR 
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BUILT-IN 

FUNCTIONS 


GRAPHICS 


SOUND AND 
GAMES 

CONTROLLERS 


WRAPAROUND 
AND KEYBOARD 
ROLLOVER 


ERROR 

MESSAGES 


The section titled FUNCTION LIBRARY explains the arithmetic and special 
functions incorporated into Atari BASIC. 


Atari graphics include 9 graphics modes. The commands have been designed 
to allow maximum flexibility in color choice and pattern variety. Section 9 ex- 
plains each command and gives examples of the many ways to use each. 


The Atari Personal Computer is capable of emitting a large variety of sounds, 
including simulated explosions, electronic music, and “raspberries.” Section 10 
defines the commands for using the SOUND function and for controlling pad- 
dle, joystick, and keyboard controllers. 


The ATARI Personal Computer System has screen wraparound thus allowing 
greater flexibility. It also allows the user to type one key ahead. If the user 
presses and holds any key, it will begin repeating after V 2 second. 


If a data entry error is made, the screen display shows the line reprinted preced- 
ed by the message ERROR- and the offending character is highlighted. After 
correcting the character in the original line, delete the line containing the 
ERROR- before pressing l;l=WU;l?l . Appendix B contains a list of all the error 
messages and their definitions. 
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2 

COMMANDS 


Whenever the cursor (□) is displayed on the screen, the computer is ready to ac- 
ceptinput. Type the command (in either Direct or Deferred mode), and press 
ihl'im • This section describes the commands used to clear computer memory 
and other useful control commands/ 

The commands explained in this section are the following: 


BYE 

NEW 

CONT 

REM 

END 

RUN 

LET 

STOP 

LIST 



BYilf (B.) Format: BYE 

Example: BYE 

The current function of the BYE command is to exit BASIC and put the com- 
puter in Memo Pad mode. This allows the user to experiment with the keyboard 
or to leave messages on the screen without disturbing any BASIC program in 
memory. To return to BASIC, press . 

CONT (CON.) Format: CONT 

Example: CONT 

Typing this comm and followed by a E3E3IB causes program execution to 
resume. If a ? STOP, or END is encountered, the program will stop until 

CONT is entered. Execution resumes at the next sequential line number 

following the statement at which the program stopped. 

Note: If the statement at which the program is halted has other commands on 
the same numbered line which were not executed at the time of the , 

STOP, or END, they will not be executed. On CONT, execution resumes at the 
next numbered line. A loop may be incorrectly executed if. the program is 
halted before the loop completes execution. 

This command has no effect in a Deferred mode program. 

END Format: END 

Example: 1000 END 

This command terminates program execution and is used in Deferred mode. In 
Atari BASIC, an END is not required at the end of a program. When the end of 
the program is reached, Atari BASIC automatically closes all files and turns off 
sounds (if any). END may also be used in Direct mode to close files and turn off 
sounds. 
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LET (LE.) 


LIST (L.) 


NEW 


REM (R. 


SPACE 


Format: [LET] var = exp 

Example: LET X = 3.142 * 16 

LET X = 2 

This statement is optional in defining variables. It can just as easily be left out of 
the statement. It may be used, however, to set a variable name equal to a value. 

Format: LIST [lineno [ , lineno] ] 

LIST [filespec [ , lineno [ , lineno] ] ] 

Examples: 

LIST 
LIST 10 
LIST, 10, 100 

LIST "P. ",20,100 


LIST "P" 

LIST "D : DEi10.LST" 


This command causes the computer to display the source version of all lines cur- 
rently in memory if the command is entered without l ine num ber(s), or to 
display a specified line or lines. For example, LIST 10,100 ESZEQ displays lines 
10 through 100 on the screen. If the user has not typed the lines into the com- 
puter in numerical order, a LIST will automatically place them in order. 

Typing L.“P will print the RAM-resident program on the printer. 


LIST can be used in Deferred mode as part of an error trapping routine (See 
TRAP in Section 4). 


The LIST command is also used in recording programs on cassette tape. The sec- 
ond format is used and a filespec is entered. (See Section 5 for more details on 
peripheral devices.) If the entire program is to be listed on tape, no line numbers 
need be specified. 

Example: LIST “Cl” 

1000 LIST “Cl” 


Format: NEW 

Example: NEW 

This command erases the program stored in RAM. Therefore, before typing 
NEW, either SAVE or CSAVE any programs to be recovered and used later. 
NEW clears BASIC’s internal symbol table so that no arrays (See Section 8) or 
strings (See Section 7) are defined. Used in Direct mode. 


Or Format: REM text 

) Example: 10 REM ROUTINE TO CALCULATE X 

This command and the text following it are for the user’s information only. It is 
ignored by the computer. However, it is included in a LIST along with the other 
numbered lines. Any statement on the same numbered line which occurs after a 
REM statement will be ignored. 
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RUN (RU.) Format: RUN [filespec] 

Examples: RUN 

RUN “D:MENU” 

This command causes the computer to begin executing a program. If no filespec 
is specified, the current RAM-resident program begins execution. If a filespec is 
included, the computer retrieves the specified, tokenized program from the 
specified file and executes it. 

All variables are set to zero and all open files and peripherals are closed. All ar- 
rays, strings, and matrices are eliminated and all sounds are turned off. Unless 
the TRAP command is used, an error message is displayed if any error is 
detected during execution and the program halts. 

RUN can be used in Deferred mode. 

Examples: 10 PRIHJ "OUER AND OUER AGAIN. " 

20 RUN 

Type RUN and press . To end, press 

To begin program execution at a point other than the first line number, type 
GOTO followed by the specific line number, then press 032033 • 

STOP (STO.) Format: STOP 

Example: 100 STOP 

When the STOP command is executed in a program, BASIC displays the 

message STOPPED AT LINE , terminates program execution, and 

returns to Direct mode. The STOP command does not close files or turn off 
sounds, so the program can be resumed by typing CONT r UJIMJ I . 


Commands 11 



NOTES 


12 Notes 



3 


EDIT 

FEATURES 


In addition to the special function keys described in Section 1, there are cursor 
control keys that allo w imm edi ate ed iting capabilities. These keys are used in 
conjunction with the or GQB keys. 

The following key functions are described in this section: 


INSERT 


FTT73 q 

GE3 o 

Gza s 


SHIFT 


r SHIFT ■ DELETE 


CAPS/LOWR 


EES 3 


BREAK 



SCREEN 

EDITING 


The keyboard and display are logically combined for a mode of operation 
known as screen editing. Each time a change is completed on the screen, the 
key must be pressed. Otherwise, the change is not made to the program 
in RAM. 


Example: 10 REM PRESS RETURN AFTER LINE EDIT 
20 PRINT : PRINT 

30 PRINT "THIS IS LINE 2 ON THE SPREE! 


To delete line 20 from the program, type the line number and press the 

key. Merely deleting the line from the screen display does not delete it from the 

program. 


The screen and keyboard as I/O devices are described in Section 5. 


°SHIFT 


Control key. Striking this key in conjunction with 
the arrow keys produces the cursor control functions 
that allow the user to move the cursor anywhere on 
the screen without changing any characters already 
on the screen. Other key combinations control the 
setting and clearing of tabs, halting and restarting 
program lists, and the graphics control symbols. 
Striking a key while holding the Q2H9 key will pro- 
duce the upper-left symbol on those keys having 
three functions. 

Shift key: This key is used in conjunction with the 
numeric keys to display the symbols shown on the 
upper half of those keys. It is also used in conjunction 


i 
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DOUBLE-KEY 

FUNCTIONS 


with other keys to insert and delete lines, return to a 
normal, upper case letter display, and to display the 
function symbols above the subtraction, equals, addi- 
tion, and multiplication operators as well as the 
brackets, [ ], and question mark,?. 

Cursor Control Keys 

GEO O Moves cursor up one physical line without changing 

the program or display. 

G23 O Moves cursor one space to the right without disturb- 

ing the program or display. 

GEB □ Moves cursor down one physical line without chang- 

ing the program or display. 

Q Moves cursor one space to the left without disturbing 

the program or display. 

Like the other keys on the Atari keyboard, holding the cursor control keys for 
more than second causes the keys to repeat. 

Keys Used With 

GEO KEUiU Inserts one character space. 

GEO 03133 Deletes one character or space. 

Q3 1 Stops temporarily and restarts screen display 

without “breaking out” of the program. 

GEO 2 Rings buzzer. 

G239 3 Indicates end-of-file. 

Keys Used With ESSO 

EES Inserts one physical line. 

Deletes one physical line. 

0232323333 Returns screen display to upper-case alphabetic 

characters. 

Special Function Keys 

WHEEZM Stops program execution or program list, prints a 

READY on the screen, and displays cursor. 

Allows commands normally used in Direct mode to 
be placed in Deferred mode; e.g., In Direct mode, 
GEO EE3 clears the screen display. To clear the 
screen in Deferred mode, type the following after the 
program line number. Press then press GEB 

and OUiiLS together. 

print “ fgm » 
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PROGRAM 

STATEMENTS 


This section explains the commands associated with loops, conditional and un- 
conditional branches, error traps, and subroutines and their retrieval. It also ex- 
plains the means of accessing data and the optional command used for defining 
variables. 

The following commands are described in this section: 

FOR, TO, STEP/NEXT IF/THEN POP 

GOSUB/RETURN ON, GOSUB RESTORE 

GOTO ON, GOTO TRAP 


FOR avar = aexpl TO aexp2 [STEP aexp3] 

NEXT avar 
FOR X = 1 TO 10 
NEXT X 

FOR Y = 10 TO 20 STEP 2 
NEXT Y 

FOR INDEX = Z TO 100 * Z 
NEXT INDEX 

This command sets up a loop and determines how many times the loop is exe- 
cuted. The loop variable (avar) is initialized to the value of aexpl. Each time the 
NEXT avar statement is encountered, the loop variable is incremented by the 
aexp3 in the STEP statement. The aexp3 can be positive or negative integers, 
decimals, or fractional numbers. If there is no STEP aexp3 command, the loop 
increments by one. When the loop completes the limit as defined by aexp2, it 
stops and the program proceeds to the statement immediately following the 
NEXT statement; it may be on the same line or on the next sequential line. 

Loops can be nested, one within another. In this case, the innermost loop is com- 
pleted before returning to the outer loop. The following example illustrates a 
nested loop program. 


FOR (FJ, TO, Format: 

STEP/NEXT (N.) 

Examples: 


10 FOR X=1 TO 3 
20 PRINT "OUTER LOOP" 

30 Z=0 
40 Z=Z+2 

50 FOR Y=1 TO 5 STEP Z 
60 PRINT " INNER LOOP" 
70 NEXT Y 
80 NEKT X 
90 END 


Figure 4-1. Nested Loop Program 
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In Figure 4-1, the outer loop will complete three passes ( X = 1 to 3 ). However, 
before this first loop reaches its NEXT X statement, the program gives control to 
the inner loop. Note that the NEXT statement for the inner loop must precede 
the NEXT statement for the outer loop. In the example, the inner loop’s number 
of passes is determined by the STEP statement (STEP Z). In this case, Z has 
been defined as 0, then redefined as Z + 2. Using this data, the computer must 
complete three passes through the inner loop before returning to the outer loop. 
The aexp3 in the step statement could also have been defined as the numerical 
value 2. 

The program run is illustrated in Figure 4-2. 


UUTER LOOP 
INNER LOOP 
INNER LOOP 
INNER LOOP 
OUTER LOOP 
INNER LOOP 
INNER LOOP 
INNER LOOP 
OUTER LOOP 
INNER LOOP- 
INNER LOOP 
INNER LOOP 


Figure 4-2. Nested Loop Execution 

The return address for the loops are placed in a special group of memory ad- 
dresses referred to as a stack. The information is “pushed” on the stack and 
when used, the information is “popped” off the stack (see POP.) 


GOSUB (GOS.) 
RETURN (RET.) 


Format: GOSUB lineno 

lineno 
RETURN 

Example: 100 GOSUB 2000 

2000 PRINT “SUBROUTINE” 
2010 RETURN 


A subroutine* is a program or routine used to compute a certain value, etc. It is 
generally used when an operation must be replaced several times within a pro- 
gram sequence using the same or different values. This command allows the 
user to “call” the subroutine 1 , if necessary. The last line of the subroutine must 
contain a RETURN statement. The RETURN statement goes back to the physical 
line following the GOSUB statement. 

Like the preceding FOR/NEXT command, the GOSUB/RETURN command 
uses a stack for its return address. If the subroutine is not allowed to complete 
normally; e.g., a GOTO lineno before a RETURN, the GOSUB address must be 
“popped” off the stack (see POP) or it could cause future errors. 


* Generally, a subroutine can do anything that can be done in a program. It is used to save memory 
and program-entering time, and to make programs easier to read and debug. 
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GOTO (G.) 


To prevent accidental triggering of a subroutine (which normally follows the 
main program), place an END statement preceding the subroutine. The follow- 
ing program demonstrates the use of subroutines. 


10 

PR I 

NT 

!l II 

28 

REM 

P> 

AMPLE 

38 

y=i 

• i * 

00 


48 

GOS 

UB 

1000 

50 

i 

20 


fcfcl 

UUS 

UB 

1000 

70 

X=58 


80 

GOS 

JB 

1000 

98 

END 




1010 y=x+r 

xvcv rkin i i 

1038 RETURN 


USE OF GOSUB/RETURN 


(Clear screen) 


Figure 4-3. GOSUB/RETURN Program Listing 


In the above program, the subroutine, beginning at line 1000, is called three 
times to compute and print out different values of X and Y. Figure 4-4 illustrates 
the results of executing this program. 


408 308 
488 368 
2 00 158 


Figure 4-4. GOSUB/RETURN Program Run 


Format: f GO TO ) aexp 

l GOTO J 

Examples: 100 GOTO 50 

500 GOTO (X + Y) 


The GOTO command is an unconditional branch statement just like the GOSUB 
command. They both immediately transfer program control to a target line 
number or arbitrary expression. However, using anything other than a con- 
stant will make renumbering the program difficult. If the target line number is 
non-existent, an error results. Any GOTO statement that branches to a 
preceding line may result in an “endless” loop. Statements following a GOTO 
statement will not be executed. Note that a conditional branching statement (see 
IF/THEN)can be used to break out of a GOTO loop. The following program il- 
lustrates two uses of the GOTO command. 


l 
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10 PRINT 

20 PRINT : PRINT "ONE" 

30 PRINT "TWO" 

40 PRINT "THREE" 

50 PRINT "FOUR" 

SO PRINT "FIUE" 

65 GOTO 100 

70 print "mmmsm-mt" 

88 PRINT "vvvvvvvvvvvvvvvvv" 
90 PRINT " ■??•?•???■???•?/•???•??? 11 
95 END 

100 PRINT "SIN" 

110 PRINT "SEUEN" 

120 PRINT "EIGHT" 

130 PRINT "NINE" 

140 PRINT "TEN" 

150 GOTO 70 


Figure 4-5. GOTO Program Listing 

Upon execution, the numbers in the above listing will be listed first followed by 
the three rows of symbols. The symbols listed on lines 70, 80, and 90 are ignored 
temporarily while the program executes the GOTO 100 command. It proceeds 
with the printing of the numbers “SIX” through “TEN”, then executes the se- 
cond GOTO statement which transfers program control back to line 70. (This is 
just an example. This program could be rewritten so that no GOTO statements 
were used.) The program, when executed, looks like the following: 


ONE 

TWO 

THREE 

FOUR 

FIUE 

SIX 

SEUEN 

EIGHT 

NINE 

TEN 


■ ** •*' ■*’ «•* I ■’ ■ 

*? YYY V Y V V V /’/*?’ /V «*' • »*' 


IF/THEN 


Figure 4-6. GOTO Program Run 

Format: IF aexp THEN | lineno I 

\ statement [:statement...] ) 
Examples: IF X = 100 THEN 150 

IF A$ = “ATARI” THEN 200 

IF AA = 145 and BB = 1 THEN PRINT AA, BB 

IF X = 100 THEN X = 0 
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The IF/THEN statement is a conditional branch statement. This type of branch 
occurs only if certain conditions are met. These conditions may be either 
arithmetical or logical. If the aexp following the IF statement is true (non-zero), 
the program executes the THEN part of the statement. If, however, the aexp is 
false (a logical 0), the rest of the statement is ignored and program control passes 
to the next numbered line. 


In the format, IF aexp THEN lineno, lineno must be a constant, not an expression 
and specifies the line number to go to if the expression is true. If several 
statements occur after the THEN, separated by colons, then they will be ex- 
ecuted if and only if the expression is true. Several IF statements may be nested 
on the same line. For example: 


100 


IF X=5 THEN IF Y=3 THEN F - 3 ■ GQ70288 


The statements R = 9: GOTO 100 will be executed only if X = 5 and Y = 3. The 
statement Y = 3 will be executed if X = 5. 

The following program demonstrates the IF/THEN statement. 


5 GRAPHICS 8-? ■? " IF DEMi'i" 

18 ? :? "ENTER A" i : INPUT A 


28 IF A=1 THEN 40: REM MULTIPLE STATEMENT 
S HERE WILL NEWER BE EXECUTED! ! 

38 ? :? "A IS NOT 1. EXECUTION CONTINUE 
S HERE WHEN THE EXPRESSION IS FALSE " 


48 IF A=1 THEN ? =? "A=l":? "YES. IT IS 
REALLY l.":REM MULTIPLE STATEMENTS HERE 
WILL BE EXECUTED ONLY IF A=1 ! i 
58 ? :? "EXECUTION CONTINUES HERE IF AO 
1 OR AFTER 'YES, IT IS REALLY 1' IS DISP- 
LAYED. " 

68 GOTO 10 


Figure 4-7. IF/THEN Program 


ENTER A 

A IS NOT 1. EXECUTION CONTINUES HERE WH 
EN THE EXPRESSION IS FALSE. 

EXECUTION CONTINUES HERE IF AOl OR AFTE 
R 'YES, IT IS REALLY 1' IS DISPLAYED. 
ENTER A 


(entered 2) 


(entered 1) 


A=1 

YES, IT IS REALLY 1 . 

EXECUTION CONTINUES HERE IF AOl OR AFTE 
R 'YES, IT IS REALLY 1' IS DISPLAYED. 
ENTER A 


Figure 4-8. IF/THEN Program Execution. 
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ON/GOSUB/ 

RETURN 

ON/GOTO 


POP 


Format: ON aexp I GOTO I lineno [ ,lineno...] 

Igosub) 

Examples: 100 ON X GOTO 200, 300, 400 
100 ON A GOSUB 1000, 2000 
100 ON SQR(X) GOTO 30, 10, 100 

1 Vote: GOSUB and GOTO may not be abbreviated. 

These two statements are also conditional branch statements like the IF/THEN 
statement. However, these two are more powerful. The aexp must evaluate to a 
positive number which is then rounded to the nearest positive integer (whole 
number) value up to 255. If the resulting number is 1, then program control 
passes to the first lineno in the list following the GOSUB or GOTO. If the 
resulting number is 2, program control passes to the second lineno in the list, 
and so on. If the resulting number is 0 or is greater than the number of linenos 
in the list, the conditions are not met and program control passes to the next 
statement which may or may not be located on the same line. With ON/GOSUB, 
the selected subroutine is executed and then control passes to the next state- 
ment. 

The following routine demonstrates the ON/GOTO statement: 


10 X=X+i 

20 ON X GOTO 100.. 230, 308; 400, 50O 
30 IF X>5 THEN PRINT "COMPLETE . " : END 
40 GOTO 18 
50 END 

100 PRINT "NOW WORKING AT LINE 108" •GOTO 
10 

280 PRINT "NOW WORKING AT LINE 288'*= GOTO 
10 

308 PRINT "NOW WORKING AT LINE 380"= GOTO 
10 

488 PRINT "NOW WORKING AT LINE 408"= GOTO 
18 

580 PRINT "NOW WORKING AT LINE 588"= GOTO 
10 


Figure 4-9 ON/GOTO Program Listing 


When the program is executed, it looks like the following: 


NOW WORKING AT LINE 188 
NOW WORKING AT LINE 208 
NOW WORKING AT LINE 388 
NOW WORK PC AT LINE 488 
NOW WORKING AT LINE 588 
COMPLETE. 


Figure 4-10 ON/GOTO Program Execution 

Format: POP 

Example: 1000 POP 
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RESTORE (RES.) 


In the description of the FOR/NEXT statement, the stack was defined as a group 
of memory addresses reserved for return addresses. The top entry in the stack 
controls the number of loops to be executed and the RETURN target line for a 
GOSUB. If a subroutine is not terminated by a RETURN statement, the top 
memory location of the stack is still loaded with some numbers. If another 
GOSUB is executed, that top location needs to be cleared. To prepare the stack 
for a new GOSUB, use a POP to clear the data from the top location in the stack. 

The POP command must be used according to the following rules: 

1. It must be in the execution path of the program. 

2. It must follow the execution of any GOSUB statement that is not brought 
back to the main program by a RETURN statement. 

The following example demonstrates the use of the POP command with a 
GOSUB when the RETURN is not executed: 


10 GOSUB 1008 

15 REM LINE 20 WILL NOT BE EXECUTED 
20 PRINT "NORMAL RETURN PRINTS THIS MESS 
AGE." 

30 PRINT "ABNORMAL RETURN PRINTS THIS ME 
SSAGE . " 

40 POP 

999 EHD 

1000 PRINT "NOW EXECUTING SUBROUTINE " 
1010 GOTO 30 

1020 RETURN 


Figure 4-11. GOSUB Statement With POP 

Format: RESTORE [aexp] 

Example: 100 RESTORE 

The Atari Personal Computer System contains an internal “pointer” that 
keeps track of the DATA statement item to be read next. Used without the op- 
tional aexp, the RESTORE statement resets that pointer to the first DATA item 
in the program. Used with the optional aexp, the RESTORE statement sets the 
pointer to the first DATA item on the line specifed by the value of the aexp. This 
statement permits repetitive use of the same data. 


10 FOR N=1 TO 2 
20 READ A 
30 RESTORE 
40 READ B 
50 M=A+B 

60 PRINT "TOTAL EQUALS ";M 
70 NEXT N 
80 Em 

90 DATA 30, 15 

Figure 4-12. Restore Program Listing 

On the first pass through the loop, A will be 30 and B will be 30 so the total lin e 
50 will print SUM TOTAL EQUALS 60, but on the second pass, A will equal 15 
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and B, because of the RESTORE statement, will still equal 30. Therefore, the 
PRINT statement in line 50 will display SUM TOTAL EQUALS 45. 


TRAP (T.) 


Format: TRAP aexp 

Example: 100 TRAP 120 

The TRAP statement is used to direct the program to a specified line number if 
an error is detected. Without a TRAP statement, the program stops executing 
when an error is encountered and displays an error message on the screen. 

The TRAP statement works on any error that may occur after it has been ex- 
ecuted, but once an error has been detected and trapped, it is necessary to reset 
the trap with another TRAP command. This TRAP command may be placed at 
the beginning of the section of code that handles input from the keyboard so 
that the TRAP is reset after each error. PEEK(195) will give you an error 
message (see Appendix B). 256*PEEK(187) + PEEK(186) will give you the number 
of the line where the error occurred. The TRAP may be cleared by executing a 
TRAP statement with an aexp whose value is from 32767 to 65535 (e.g., 40000). 
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INPUT/OUTPUT 
COMMANDS AND DEVICES 


This section describes the input/output devices and how data is moved between 
them. The commands explained in this section are those that allow access to the 
input/output devices. The input commands are those associated with getting 
data into the RAM and the devices geared for accepting input. The output com- 
mands are those associated with retrieving data from RAM and the devices 
geared for generating output. 

The commands described in this section are: 


INPUT/OUTPUT 

DEVICES 


CLOAD 

CSAVE 

DOS 

ENTER 


INPUT OPEN/CLOSE READ/DATA 

LOAD POINT SAVE 

LPRINT PRINT STATUS 

NOTE PUT/GET XIO 


The hardware configuration of each of the following devices is illustrated in the 
individual manuals furnished with each. The Central Input/Output (CIO) sub- 
system provides the user with a single interface to access all of the system 
peripheral devices in a (largely) independent manner. This means there is a 
single entry point and a device-independent calling sequence. Each device has a 
symbolic device name used to identify it; e.g., K: for the keyboard. Each device 
must be opened before access and each must be assigned to an Input/Output Con- 
trol Block (IOCB). From then on, the device is referred to by its IOCB number. 


ATARI BASIC contains 8 blocks in RAM which identifies to the Operating 
System the information it needs to perform an I/O operation. This information 
includes the command, buffer length, buffer address, and two auxiliary control 
variables. ATARI BASIC sets up the IOCB’s, but the user must specify which 
IOCB to use. BASIC reserves IOCB #0 for I/O to the Screen Editor, therefore the 
user may not request IOCB m. The GRAPHICS statement (see Section 9) opens 
IOCB #& for input and output to the screen. (This is the graphics window S:). 
IOCB #7 is used by BASIC for the LPRINT, CLOAD, and CSAVE commands. The 
IOCB number may also be referred to as the device (or file) number. IOCB’s 1 
through 5 are used in opening the other devices for input/output operations. If 
IOCB tn is in use, it will prevent LPRINT or some of the other BASIC I/O 
statements from being performed. 

Keyboard: (K:) Input only device. The keyboard allows the user to read the 
converted (ATASCII) keyboard data as each key is pressed. 

Line Printer: (P:) Output only device. The line printer prints ATASCII 
characters, a line at a time. It recognizes no control characters. 

Program Recorder: (C:) Input and Output device. The recorder is a read/write 
device which can be used as either, but never as both simultaneously. The 
cassette has two tracks for sound and program recording purposes. The audio 
track cannot be recorded from the ATARI system, but may be played back 
through the television speaker. 
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CLOAD (CLOA.) 


CSAVE (CS.) 


Disk Drives: (Dl:, D2:, D3:, D4:) Input and Output devices. If 16K of RAM is 
installed, the ATARI can use from one to four disk drives. If only one disk drive 
is attached, there is no need to add a number after the symbolic device code D. 

Screen Editor: (E:) Input and Output device. This device uses the keyboard 
and display (see TV Monitor) to simulate a screen editing terminal. Writing to 
this device causes data to appear on the display starting at the current cursor 
position. Reading from this device activates the sc reen editing process and 
allows the user to enter and edit data. Whenever the key is pressed, the 

entire logical line within which the cursor resides is selected as the current 
record to be transferred by CIO to the user program. (See Section 9). 

TV Monitor: (S:) Input and Output device. This device allows the user to read 
characters from and write characters to the display, using the cursor as the 
screen addressing mechanism. Both text and graphics operations are supported. 
See Section 9 for a complete description of the graphics modes. 

Interface, RS-232: (R:) The RS-232 device enables the ATARI system to inter- 
face with RS-232-compatible devices such as printers, terminals, and plotters. It 
contains a parallel port to which the 80-column printer (ATARI 825™) can be at- 
tached. 


Format: CLOAD 

Examples: CLOAD 

100 CLOAD 

This command can be used in either Direct or Deferred mode to load a program 
from cassette tape into RAM for execution. On entering CLOAD, one b ell ring s 
to indicate that the PLAY button needs to be pressed followed by SHEEU . 
However, do not press PLAY until after the tape has been positioned. Specific in- 
structions for CLOADing a program are contained in the ATARI 410 Program 
Recorder Manual. Steps for loading oversized programs are included in the 
paragraphs under CHAINING PROGRAMS at the end of this section. 


Format: CSAVE 

Examples: CSAVE 

100 CSAVE 
100 CS. 

This command is usually used in Direct mode to save a RAM-resident program 
onto cassette tape. CSAVE saves the tokenized version of the program. On enter- 
ing CSAVE two bells ring to indicate that the PLAY and RECORD buttons must 
be pressed followed by . Do not, however, press these buttons until the 

tape has been positioned. It is faster to save a program using this command 
rather than a SAVE cc C” (see SAVE) because short inter-record gaps are used. 

Notes: Tapes saved using the two commands, SAVE and CSAVE, are not com- 
patible 

It may be necessary to enter an LPRINT (see LPRINT) before using 
CSAVE. Otherwise, CSAVE may not work properly. 

For specific instructions on how to connect and operate the hardware, 
cue the tape, etc., see the ATARI 410 Program Recorder Manual. 
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DOS (DO.) 


Format: DOS 

Example: DOS 


The DOS command is used to go from BASIC to the Disk Operating System 
(DOS). If the Disk Operating System has not been booted into memory, the com- 
puter will go into Memo Pad mode and the user must press to return 

to Direct mode. If the Disk Operating System has been booted, the DOS Menu is 
displayed. To clear the DOS Menu from the screen, press H'f-UdJl-.lkm . Control 
then passes to BASIC. Control can also be returned to BASIC by selecting B (Run 
Cartridge) on the DOS Menu. 

The DOS command is usually used in Direct mode; however, it may be used in a 
program. For more details on this, see the Atari DOS Manual. 

ENTER (E.) Format: ENTER filespec 

Examples: ENTER “C 

ENTER “D:DEMOPR.INS” 

This statement causes a cassette tape to play back a program originally recorded 
using LIST (see Section 2, LIST). The program is entered in unprocessed (un- 
tokenized) form, and is interpreted as the data is received. When the loading is 
complete, it may be run in the normal way. The ENTER command may also be 
used with the disk drive. Note that both LOAD and CLOAD (see Section 2) clear 
the old program from memory before loading the new one. ENTER merges the 
old and new programs. This ENTER statement is usually used in Direct mode. 

INPUT (I.) Format: INPUT [*aexp ( ’; )] { Ivar I [, { Zlr I -l 

Examples: 100 INPUT X 
100 INPUT N$ 

100 PRINT “ENTER THE VALUE OF X” 

110 INPUT X 

This statement requests keyboard data from the user. In execution, the com- 
puter displays a ? prompt when the program encounters an INPUT statement. It 
is usually preceded by a PRINT statement that prompts the user as to the type of 
information being requested. 

String variables are allowed only if they are not subscripted. Matrix variables 
are not allowed. 

The #aexp is optional and is used to specify the file or device number from 
which the data is to be input (see Input/Output Devices). If no #aexp is specified, 
then input is from the screen editor (E:). 

Ifjseveral strings are to be input from the screen editor, type one string, press 
CMl 5 type the next string, CS3S33 • etc. Arithmetic numbers can be typed on 
the same line separated by commas. 


10 PRINT “ENTER 5 NUMBERS TO BE SUMMED" 

20 FOR N=1 TO 5 
30 INPUT X 
40 C=C+X 
50 NEXT N 

60 PRINT "THE SUM OF YOUR: NUMBERS IS ";C 
70 END 

Figure 5-1 Input Program Listing 
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LOAD (LO.) 


LPRINT (LP.) 


NOTE (NO.) 


OPEN (O.) 
CLOSE (CL.) 


Format: LOAD filespec 

Example: LOAD “D1JANINE.BRY” 

This command is similar to CLOAD except the full file name system can be used. 
LOAD uses long inter-record gaps on the tape (see CLOAD) and uses the token- 
ized version of the program. When using only one disk drive, it is not necessary 
to specify a number after the “D” because the default is disk drive 


Format: LPRINT [ex piii \ | exp..J 

Example: LPRINT “PROGRAM TO CALCULATE X” 

100 LPRINT X;“ ”;Y;“ ”;Z 


This statement causes the computer to print data on the line printer rather than 
on the screen. It can be used in either Direct or Deferred modes. It requires no 
device specifier and no OPEN or CLOSE statement. (BASIC uses IOCB #7.) 


The above program listing illustrates a program that will add 5 numbers 
entered by the user. To print a program listing on the line printer, see LIST. 


Format: NOTE #aexp, avar, avar 

Example: 100 NOTE #1, X, Y 

This command is used to store the current disk sector number in the first avar 
and the current byte number within the sector in the second avar. This is the 
current read or write position in the specified file where the next byte to be 
read or written is located. This NOTE command is used when writing data to a 
disk file (see POINT). The information in the NOTE command is written into a 
second file which is then used as an index into the first file. 


Formats: OPEN #aexp,aexpl,aexp2, filespec 

CLOSE #aexp 

Examples: 100 OPEN #2,8,0,“D1:ATARI800.BAS” 

100 A$ = “D1:ATARI800.BAS” 

110 OPEN #2,8,0,A$ 

150 CLOSE #2 

Before a device can be accessed, it must be opened. This “opening” process links 
a specific IOCB to the appropriate device handler, initializes any CIO-related con- 
trol variables, and passes any device-specific options to the device handler. The 
parameters for the OPEN command are defined as follows: 

ft Mandatory character that must be entered by the 

user. 

aexp Reference IOCB or file number to same parameters 

for future use (as in CLOSE command). Number 
may be 1 through 7. 
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aexpl 


Code number to determine input or output opera- 
tion. 


Code 4 
8 

12 

6 


9 


input operation 
output operation 
input and output operation 
disk directory input operation 
(In this case, the filespec is the search specifica- 
tion.) 

end-of-file append (output) operation. Append is 
also used for a special screen editor input mode. 
This mode allows a program to input the next 
line from E: without waiting for the user to press 


RETURN 


aexp2 Device-dependent auxiliary code. An 83 in this 

parameter indicates sideways printing on a printer 
(see appropriate manuals for control codes). 

filespec Specific file designation. Must be enclosed in quota- 
tion marks. The format for the filespec parameter 
is shown in Figure 5-2. 

“D 1 : A T A R I 8 0 0 . B A S” 



characters- 
must begin 
with alphabetic 
character) 

Period required - 
as separator if 
extender is used. 

Extender 

(optional)- 

Includes 

0-3 characters 


Note: Filenames are 
not used with 
the program 
recorder. 


Figure 5-2 Filename Breakdown 

The CLOSE command simply closes files that have been previously opened with 
an OPEN command. Note in the example that the aexp following the mandatory 
# character must be the same as the aexp reference number in the OPEN state- 
ment. 
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POINT (P.) 


PRINT (PR or ?) 


PUT(PU.)/ 

GET(GE.) 


READ (REA.) 
DATA (D.) 


Format: POINT #aexp, avar, avar 

Example: 100 POINT #2, A,B 

This command is used when reading a file into RAM. The first avar specifies the 
sector number and the second avar specifies the byte within that sector where 
the next byte will be read or written. Essentially, it moves a software-controlled 
pointer to the specified location in the file. This gives the user “random” access 
to the data stored on a disk file. The POINT and NOTE commands are discussed 
in more detail in the DOS Manual. 

Format: PRINT [#aexp] | ’ j [exp] [,exp...] 

Examples: PRINT X, Y, Z, A$ 

100 PRINT “THE VALUE OF X IS ”;X 

100 PRINT “COMMAS”, “CAUSE”, “COLUMN”, “SPACING” 

100 PRINT #3, A$ 


A PRINT command can be used in either Direct or Deferred mode. In Direct 
mode, this command prints whatever information is contained between the 
quotation marks exactly as it appears. In the first example, PRINT X,Y,Z,A$, the 
screen will display the current values of X,Y,Z, and A$ as they appear in the 
RAM-resident program. In the last example, PRINT #3,A$, the #3 is the file 
specifier (may be any number between 1 and 7) that controls to which device 
the value of A$ will be printed. (See Input/Output Devices.) 

A comma causes tabbing to the next tab location. Several commas in a row cause 
several tab jumps. A semicolon causes the next aexp or sexp to be placed im- 
mediately after the preceding expression with no spacing. Therefore, in the 
second example a space is placed before the ending quotation mark so the value 
of X will not be placed immediately after the word “IS”. If no comma or 
semicolon is used at the end of a PRINT statement, then a Blsfllhlgl is output and 
the next PRINT will start on the following line. 

Format: PUT #aexp, aexp 

GET #aexp, 

Examples: 100 PUT #6, ASC(“A”) 

200 GET #1,X 

The PUT and GET are opposites. The PUT command putputs a single byte from 
0-255 to the file specified by #aexp. (# is a mandatory character in both these 
commands). The GET command reads one byte from 0-255 (using #aexp to 
designate the file, etc. on diskette or elsewhere) and then stores the byte in the 
variable avar. 


Formats: READ var [ , var...] 

DATA adata [ , adata...] 

Examples: 100 READ A,B,C,D,E 

110 DATA 12,13,14,15,16 
100 READ A$,B$,C$,D$,E$ 

110 DATA EMBEE, EVELYN, CARLA, CORINNE, BARBARA 


These two commands are always used together and the DATA statement is 
always used in Deferred mode 1 . The DATA statement can be located anywhere 

*A Direct mode READ will only read data if a DATA statement was executed in the program. 
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SAVE (S.) 


STATUS (ST.) 


XIO (X.) 


in the program, but must contain as many pieces of data as there are defined in 
the READ statement. Otherwise, an “out of data” error is displayed on the 
screen. 

String variables used in READ statements must be dimensioned and cannot be 
subscripted. (See STRINGS Section). Neither may array variables may be used in 
a READ statement. 

The DATA statement holds a number of string data for access by the READ 
statement. It cannot include arithmetical operations, functions, etc. Further- 
more, the data type in the DATA statement must match the variable type de- 
fined in the corresponding READ statement. 

The following program totals a list of numbers in a DATA statement: 


10 FOR N=1 TO 5 
20 READ D 
30 ri=M+o 
40 NEXT H 

50 PRINT "SUM TOTAL EQUALS Ml 
60 END 

70 DATA 30,15,106,17,87 


Figure 5-3 Read/Data Program Listing 

The program, when executed, will print the statement: 

SUM TOTAL EQUALS 255. 


Format: SAVE filespec 

Example: SAVE “Dl:YVONNE.PAT” 

The SAVE command is similar to the CSAVE command except that the full file 
name system can be used. The device code number is optional when using only 
one disk drive. The default is to disk drive #1. SAVE, like LOAD, uses long inter- 
record gaps on the cassette (see CSAVE) and the tokenized form of the program. 


Format: STATUS #aexp,avar 

Example: 350 STATUS #1,Z 

The STATUS command calls the STATUS routine for the specified device (aexp). 
The status of the STATUS command (see ERROR MESSAGES, Appendix B) is 
stored in the specified variable (avar). This may be useful for future devices such 
as the RS-232 interface. 


Format: XIO cmdno, #aexp, aexpl, aexp2, filespec 

Example: XIO 18,#6,0,0,“S:” 

The XIO command is a general input/output statement used for special opera- 
tions. One example is its use to fill an area on the screen between plotted points 
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and lines with a color (see Section 9). The parameters for this command are de- 
fined as follows: 

cmdno Number that stands for the particular command to 
be performed. 


cmdno 

OPERATION 

EXAMPLE 

3 

OPEN 

Same as BASIC OPEN 

5 

GET RECORD 

These 4 commands are similar to 

7 

GET CHARACTERS 

BASIC INPUT GET, PRINT, and PUT 

9 

PUT RECORD 

11 

PUT CHARACTERS 

respectively. 

12 

CLOSE 

Same as BASIC CLOSE 

13 

STATUS REQUEST 

Same as BASIC STATUS 

17 

DRAW LINE 

Same as BASIC DRAWTO 

18 

FILL 

See Section 9 

32 

RENAME 

XIO 32, #1,0,0,“D:TEMP. CAROL” 

33 

DELETE 

XIO 33,#1,0,0,“D:TEMP.BAS” 

35 

LOCK FILE 

XIO 35,#1,0,0,“D:TEMP.BAS” 

36 

UNLOCK FILE 

XIO 36,#1,0,0,“D:TEMP.BAS” 

37 

POINT 

Same as BASIC POINT 

38 

NOTE 

Same as BASIC NOTE 

254 

FORMAT 

XIO 254,#1,0,0,“D2:” 


aexp Device number (same as in OPEN). Most of the time 

it is ignored, but must be preceded by #. 

aexpl Two auxiliary control bytes. Their usage 

aexp2 depends on the particular device and command. In 

most cases, they are unused and are set to 0. 

filespec String expression that specifies the device. Must be 
enclosed in quotation marks. Although some com- 
mands, like Fill (Section 9), do not look at the 
filespec, it must still be included in the statement. 


CHININ' Q If a program requires more memory than is available, use the following steps to 

PROGRAMS string programs of less than the maximum memory available into one program. 

f • Type in the first part of the program in the normal way. 

2. The last line of the first part of the. program should contain only the line 
number and the command RUN“C:” 

3. Cue the tape to the blank section. Write down the program counter number 
for later RUN purposes. Press PLAY and RECORD buttons on the deck so that 
both remain down. 

4. Type SAVE“C:” and press . 

5. When the beeping sound occurs, press again. 

6. When the screen displays “READY”, do not move tape. Type NEW . 

7. Repeat the above instructions for the second part of the program. 

8. As the second part of the program is essentially a totally new program, it is 
possible to re-use the line numbers used in the first part of the program. 

9. If there is a third part of the program, make sure the last line of the second 
part is a RUN“C:” command. 
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To execute a “chained” program, use the following steps: 

1. Cue the tape to the beginning of part 1 of the program. 

2. Press PLAY button on the recorder. 

3. Type RUN“C:”E!iD . 

4. When the “beep” sounds, press l;l=UU;m again. 

The computer automatically loads the first part of the program, runs it, and 
sounds a “beep” to indicate when to hit the space bar or to trigger the 

tape motor for the second LOAD/RUN. The loading takes a few seconds. 

Note: A one-part program can be recorded and reloaded in the same way or 
CSAVE and CLOAD can be used. 


Note: Remember to boot DOS before typing in your program. 

MODIFYING A The procedure for modifying an existing BASIC program stored on a diskette is 
PROGRAM demonstrated in the following steps: 

ON DISK i. Turn off ATARI console and insert BASIC cartridge. 

2. Connect disk drive and turn it on - without inserting diskette. 

3. Wait for Busy Light to go out and for the drive to stop. Open disk drive door. 

4. Insert diskette (with DOS) and close door. 

5. Turn on console. DOS should boot in and the screen show READY. 

6. To load program from disk, type 

LOAD “D:filename.ext 

7. Modify program (or type in new program) . 

8. To save program on disk, type 

SAVE “D:filename.ext 

9. Always wait for the Busy light to go out before removing diskette. 

10. To get a Directory listing, do not remove diskette and type 

DOS 

Upon , the DOS Menu will be displayed. Select command letter A, 

type it, and press twice to list the directory on the screen; or type A 

followed by pressing QS3333 then P: EaEEEIto list directory on the printer. 

11. To return to BASIC, type B or press EEEHE2J • 
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NOTES 


32 Notes 
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ARITHMETIC 

FUNCTIONS 

ABS 


CLOG 


EXP 


INT 


FUNCTION 

LIBRARY 


This section describes the arithmetic, trigonometric, and special purpose func- 
tions incorporated into the ATARI BASIC. A function performs a computation 
and returns the result (usually a number) for either a print-out or additional 
computational use. Included in the trigonometric functions are two statements, 
radians (RAD) and degrees (DEG), that are frequently used with trigonometric 
functions. Each function described in this section may be used in either Direct 
or Deferred mode. Multiple functions are perfectly legal. 

The following functions and statements are described in this section: 


ABS 

ATN 

ADR 

CLOG 

COS 

FRE 

EXP 

SIN 

PEEK 

INT 

DEG/RAD 

POKE 

LOG 


USR 

RND 



SGN 



SQR 




Format: ABS(aexp) 

Example: 100 AB = ABS (-190) 

Returns the absolute value of a number without regard to whether it is positive 
or negative. The returned value is always positive. 


Format: CLOG (aexp) 

Example: 100 C = CLOG(83) 

Returns the logarithm to the base 10 of the variable or expression in paren- 
theses. CLOG(O) should give an error and CLOG(l) should be 0. 


Format: EXP (aexp) 

Example: 100 PRINT EXP(3) 

Returns the value of e (approximately 2.71828283), raised to the power specified 
by the expression in parentheses. In the example given above, the number 
returned is 20.0855365. In some cases, EXP is accurate only to six significant 
digits. 


Format: INT (aexp) 

Examples: 100 I = INT(3.445) ( 3 would be stored in I) 

100 X = INT(- 14.66778) (-15 would be stored in X) 
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Returns the greatest integer less than or equal to the value of the expression. 
This is true whether the expression evaluates to a positive or negative number. 
Thus, in our first example above, I is used to store the number 3. In the second 
example, X is used to store the number - 15 (the first whole number that is less 
than or equal to - 14.66778). This INT function should not be confused with the 
function used on calculators that simply truncates (cuts off) all decimal places. 

LOG Format: LOG(aexp) 

Example: 100 L = LOG(67.89/2.57) 

Returns the natural logarithm of the number or expression in parentheses. 
LOG(O) should give an error and LOG(l) should be 0. 

RND Format: RND(aexp) 

Example: 10 A = RND (0) 

Returns a hardware-generated random number between 0 and 1, but never 
returns 1. The variable or expression in parentheses following RND is a dummy 
and has no effect on the numbers returned. However, the dummy variable must 
be used. Generally, the RND function is used in combination with other BASIC 
statements or functions to return a number for games, decision making, and the 
like. Here’s a simple routine that returns a random number between 0 and 999. 


10 X=RND<0J (0 is dummy variable) 

20 RX=IMT< 1000#X) 

30 PRINT RX 


Format: SGN(aexp) 

Example: 100 X = SGN(-199) (-1 would be returned) 

Returns a -1 if aexp evaluates to a negative number; a 0 if aexp evaluates to 0, or a 
1 if aexp evaluates to a positive number. 

Format: SQR(aexp) 

Example: 100 PRINT SQR(100) (10 would be printed) 

Returns the square root of the aexp which must be positive. 


TRIGONOMETRIC 

FUNCTIONS 


ATN Format: ATN(aexp) 

Example: 100 X = ATN(65) 

Returns the arctangent of the variable or expression in parentheses. 

COS Format: COS(aexp) 

Example: 100 C = COS(X + Y + Z) 

Note: Presumes X, Y, Z previously defined! 

Returns the trigonometric cosine of the expression in parentheses. 
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SGN 

SQ£ 



SIN 


DEG/RAD 


SPECIAL 

PURPOSE 

FUNCTIONS 

ADR 


FRE 


PEEK 


POKE 


Format: SIN(aexp) 

Example: 100 X = SIN(Y) 

Note: Presumes Y previously defined. 

Returns the trigonometric sine of the expression in parentheses. 


Format: DEG 

RAD 

Example: 100 DEG 

100 RAD 

These two statements allow the programmer to specify degrees or radians for 
trigonometric function computations. The computer defaults to radians unless 
DEG is specified. Once the DEG statement has been executed, RAD must be used 
to return to radians. 

See Appendix E for the additional trigonometric functions that can be derived. 


Format: ADR(svar) 

Example: ADR(A$) 

Returns the decimal memory address of the string specified by the expression in 
parentheses. Knowing the address enables the programmer to pass the informa- 
tion to USR routines, etc. (See USR and Appendix D) 

Format: FRE(aexp) 

Examples: PRINT FRE (0) 

100 IF FRE (0)< 1000 THEN PRINT “MEMORY CRITICAL” 

This function returns the number of bytes of user RAM left. Its primary use is in 
Direct mode with a dummy variable (0) to inform the programmer how much 
memory space remains for completion of a program. Of course FRE can also be 
used within a BASIC program in Deferred mode. 

Format : PEEK(aexp) 

Examples: 1000 IF PEEK (4000) = 255 THEN PRINT “255” 

100 PRINT “LEFT MARGIN IS”; PEEK (82) 

Returns the contents of a specified memory address location (aexp). The address 
specified must be an integer or an arithmetic expression that evaluates to an in- 
teger between 0 and 65535 and represents the memory address in decimal nota- 
tion (not hexadecimal). The number returned will also be a decimal integer with 
a range from 0 to 255. This function allows the user to examine either RAM or 
ROM locations. In the first example above, the PEEK is used to determine 
whether location 4000 (decimal) contains the number 255. In the second exam- 
ple, the PEEK function is used to examine the left margin. 

Format: POKE aexpl, aexp2 

Examples: POKE 82, 10 

100 POKE 82, 20 
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USR 


Although this is not a function, it is included in this section because it is closely 
associated with the PEEK function. This POKE command inserts data into the 
memory location or modifies data already stored there. In the above format, 
aexpl is the decimal address of the location to be poked and aexp2 is the data to 
be poked. Note that this number is a decimal number between 0 and 255. POKE 
cannot be used to alter ROM locations. In gaining familiarity with this command 
it is advisable to look at the memory location with a PEEK and write down the 
contents of the location. Then, if the POKE doesn’t work as anticipated, the 
original contents can be poked into the location. 

The above Direct mode example changes the left screen margin from its default 
position of 2 to a new position of 10. In other words, the new margin will be 8 
spaces to the right. To restore the margin to its normal default position, press 


SYSTEM RESET 1 


Format: USR (aexpl [, aexp2][, aexp3...]) 

Example: 100 RESULT = USR (ADD1,A*2) 

This function returns the results of a machine-language subroutine. The first ex- 
pression, aexpl, must be an integer or arithmetic expression that evaluates to an 
integer that represents the decimal memory address of the machine language 
routine to be performed. The input arguments aexp2, aexp3, etc., are optional. 
These should be arithmetic expressions within a decimal range of 0 through 
65535. A non-integer value may be used; however, it will be rounded to the 
nearest integer. 

These values will be converted from BASIC’s Binary Coded Decimal (BCD) 
floating point number format to a two-byte binary number, then pushed onto 
the hardware stack, composed of a group of RAM memory locations under 
direct control of the 6502 microprocessor chip. Figure 6-1 illustrates the struc- 
ture of the hardware stack. 

N (Number of arguments on the stack-may be 0) 

X t (High byte of argument X) 

X 2 (Low byte of argument X) 

Y t (High byte of argument Y) 

Y 2 (Low byte of argument Y) 

(High byte of argument Z) 

Z 2 (Low byte of argument Z) 


R t (Low byte of return address) 

R 2 (High byte of return address) 

Figure 6-1 . Hardware Stack Definition 

Note: X is the argument following the address of the routine, Y is the 
second, Z is the third, etc. There are N pairs of bytes. 

See Section 11 for a description of the USR function in machine language pro- 
gramming. Appendix D defines the bytes in RAM available for machine 
language programming. 
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ASC 


CHR$ 


STRINGS 


This section describes strings and the functions associated with string handling. 
Each string must be dimensioned (see DIM statement, Section 8) and each string 
variable must end with a $. A string itself is a group of characters “strung” 
together. The individual characters may be letters, numbers, or symbols 
(including the Atari special keyboard symbols.) A substring is a part of a longer 
string and any substring is accessible in Atari BASIC if the string has been pro- 
perly dimensioned (see end of section). The characters in a string are indexed 
from 1 to the current string length, which is less than or equal to the dimen- 
sioned length of the string. 

The string functions described in this section are: 

ASC STR$ 

CHR$ VAL 

LEN 


Format: ASC(sexp) 

Examples: 100A = ASC(A$) 


This function returns the ATASCII code number for the first character of the 
string expression (sexp). This function can be used in either Direct or Deferred 
mode. Figure 7-1 is a short program illustrating the ASC function. 


10 Din h*<3> 
20 

30 A=A3C(A$> 
40 PRINT A 


Figure 7-1. ASC Function Program 


When executed, this program prints a 69 which is the ATASCII code for the let- 
ter “E”. Note that when the string itself is used, it must be enclosed in quotation 
marks. 


Format: CHR$ (aexp) 

Examples: 100 PRINT CHR$ (65) 

100 A$ = CHR$ (65) 

This character string function returns the character, in string format, 
represented by the ATASCII code number(s) in parentheses. Only one character 
is returned. In the above examples, the letter A is returned. Using the ASC and 
CHR$ functions, the following program prints the upper case and lower case let- 
ters of the alphabet. 
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LEN 


STR$ 


VAL 


18 FOR 1=8 TO 25 

28 PRINT CHR*<ASC< ?, A">+I 

I) 

38 NEXT I 


CHR*< ASC( “a" )+ 


Figure 7-2. ASC and CHR$ Program Example 
Note: There can be only one STR$ and only one CHR$ in a logical comparison. 


Formats LEN (sexp) 

Example: 100 PRINT LEN(A$) 

This function returns the length in bytes of the designated string. This informa- 
tion may then be printed or used later in a program. The length of a string 
variable is simply the index for the character which is currently at the end of 
the string. Strings have a length of 0 until characters have been stored in them. 
It is possible to store into the middle of the string by using subscripting. 
However, the beginning of the string will contain garbage unless something 
was stored (using STO) there previously. 

The following routine illustrates one use of the LEN function: 

18 dim m.m 

28 A*=" ATARI" 

38 PRINT LEN(A$) 

Figure 7-3. LEN Function Example 

The result of running the above program would be 5. 


Formats STR$ (aexp) 

Example: A$ = STR$(65) 

This string from number function returns the string form of the number in 
parentheses. The above example would return the actual number 65, but it 
would be recognized by the computer as a string. 

Note: There can only be one STR$ and only one CHR$ in a logical comparison. 
For example, A = STR$(1) > STR$(2) is not valid and will not work correctly. 

Formats VAL(sexp) 

Example: 100 A = VAL(A$) 

This function returns a number of the same value as the number stored as a 
string. This is the opposite of a STR$ function. Using this function, the computer 
can perform arithmetic operations on strings as shown in the following exam- 
ple program: 

18 DIM B«5) 

28 B$= H 18808 11 
38 B=SQR< UAL< B$ > > 

48 PRINT "THE SQUARE ROOT OF IS " 

Figure 7-4. VAL Function Program 
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Upon execution, the screen displays THE SQUARE ROOT OF B$ IS 100. 


It is not possible to use the VAL function with a string that does not start with a 
number, or that cannot be interpreted by the computer as a number. It can, 
however, intrepret floating point numbers; e.g.,VAL(“lE9”)would return the 
number 1,000,000,000. 


STRING Strings can be manipulated in a variety of ways. They can be split, concatenated, 

MANIPULATIONS rearranged, and sorted. The following paragraphs describe the different 

manipulations. 

String Concatenation 

Concatenation means putting two or more strings together to form one large 
string. Each string to be included in a larger string is called a substring. Each 
substring must be dimensioned (see DIM). In Atari BASIC, a substring can con- 
tain up to 99 characters (including spaces). After concatenation, the substrings 
can be stored in another string variable, printed, or used in later sections of the 
program. Figure 7-5 is a sample program demonstrating string concatenation. 
In this program, A$, B$, and C$ are concatenated and placed in A$. 

10 D I H AIC 1 00 } , BIC 1 00 > , Ct( 1 00 > 

20 Al=" STRINGS & SUBSTRINGS ARE DISCUSSE 
D " 

30 BI=‘TN ’ATARI BASIC— A SELF-TEACHING 
GUIDE"’ 

40 Cl=" — CHAPTER 9." 

50 AICLENCAI)+1>=BI 
60 AtC LEHC At >+l )=Ct 
70 PRINT At 

Figure 7-5. String Concatenation Example 
String Splitting 


The format of a subscript string variable is as follows: 

svarname(aexpl[ ,aexp2]) 

The svarname is used to indicate the unsubscripted string variable name (with 
$). aexpl indicates the starting location of the substring and aexp2 (if used) in- 
dicates the ending location of the substring. If no aexp2 is specified, then the end 
of the substring is the current end of the string. The starting location cannot be 
greater than the current length of the string. The two example programs in 
Figure 7-6 illustrate a split string with no end location indicated and a split 
string with an ending location indicated. 


10 DIM SIC 5 ) 

20 SI=“ABCD#" 

30 PRINT SIC 2) 

40 END 

Result is BCD. 

(without ending location) 


10 DIM SIC 20;- 

20 S!=" ATARI 800 BASIC 

30 PRINT SIC 7,9) 

40 END 

Result is 800. 

(with ending location) 


Figure 7-6. Split String Examples 
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String Comparisons and Sorts 

In string comparisons, the logical operators are used exactly the way they are 
with numbers. The second program in Appendix H is a simple example of bub- 
ble sort. 

In using logical operators, remember that each letter, number, and symbol is 
assigned an ATASCII code number. A few general rules apply to these codes: 

1. ATASCII codes for numbers are sized in order of the numbers’ real 
values and are always lower than the codes for letters (see Appendix C). 

2. Upper case letters have lower numerical values than the lower case let- 
ters. To obtain the ATASCII code for a lower case letter if you know the 
upper case value, add 32 to the upper case code. 

Note: Atari BASIC’s memory management system moves strings around in 
memory to make room for new statements. This causes the string address to 
vary if a program is modified or Direct mode is used. 
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ARRAYS AND 
MATRICES 


An array is a one-dimensional list of numbers assigned to subscripted variables; 
e.g., A(0), A(l), A (2). Subscripts range from 0 to the dimensioned value. Figure 
8-1 illustrates a 7-element array. 


A(0) 
A(l) 
A (2) 
A(3) 
A (4) 
A(5) 
A(6) 


Figure 8-1. Example of an Array 

A matrix, in this context, is a two-dimensional table containing rows and col- 
umns. Rows run horizontally and columns run vertically. Matrix elements are 
stored by BASIC in row-major order. This means that all the elements of the 
first row are stored first, followed by all the elements of the second row, etc. 
Figure 8-2 illustrates a 7x4 matrix. 


Columns 


DIM (DI.) 


M(0,0) 

M(0,1) 

M(0,2) 

M(0,3) 

M(1,0) 

M(l,l) 

M(l,2) 

M(l,3) 

M(2,0) 

M(2,l) 

M(2,2) 

M(2,3) 

M(3,0) 

M(3,l) 

M(3,2) 

M(3,3) 

M(4,0) 

M(4,l) 

M(4,2) 

M(4,3) 

M(5,0) 

M(5,l) 

M(5,2) 

M(5,3) 

M(6,0) 

M(6,l) 

M(6,2) 

M(6,3) 


Figure 8-2. Example of a Matrix 


This section describes the two commands associated with arrays, matrices, and 
strings, and how to load both arrays and matrices. The commands in this sec- 
tion are: 


DIM 

CLR 


Format: 


DIM 


svar(aexp) 
mvar(aexp[ ,aexp]) 


,svar(aexp) 

,mvar(aexp [ ,aexp . . . ] 


Examples: DIM A(100) 

DIM M(6,3) 

DIM B$(20) used with STRINGS 
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A DIM statement is used to reserve a certain number of locations in memory for 
a string, array, or matrix. A character in a string takes one byte in memory and 
a number in an array takes six bytes. The first example reserves 101 locations 
for an array designated A. The second example reserves 7 rows by 4 columns 
for a two-dimensional array (matrix) designated M. The third example reserves 
20 bytes designated B$. All strings, arrays, and matrices must be dimen- 
sioned. It is a good habit to put all DIM statements at the beginning of the pro- 
gram. Notice in Figure 8-1 that although the array is dimensioned as DIM A(6), 
there are actually 7 elements in the array because of the 0 element. Although 
Figure 8-2 is dimensioned as DIM M(6,3), 28 locations are reserved. 


Note: The ATARI Personal Computer does not automatically initialize array or 
matrix variables to 0 at the start of program execution. To initialize array or 
matrix elements to 0, use the following program steps: 


250 DIM H(100) 

300 FOR E=0 TO 100 
310 h(3)=0 
320 NEXT E 


Arrays and matrices are “filled” with data by using FOR/NEXT statements, 
READ/DATA statements and INPUT commands. Figure 8-3 illustrates the 
“building” of part of an array using the FOR/NEXT loop and Figure 8-4 builds an 
array using the READ/DATA statements. 


10 DIM A( 100) 

20 X— 18 

30 FOR E=1 TO 90 
40 X=X+1 
50 A(E)=X 
60 NEXT E 
70 FOR E=1 TO 90 
80 PRINT E. h(E) 
90 NEXT E 


Figure 8-3. Use of FOR/NEXT to Build An Array 


10 DIM A( 3 > 

20 FOR E=1 TO 3 
30 READ X 
40 A<E)=X 
50 PRINT A<E>, 

60 NEXT E 
70 END 

100 DATA 33.. 45; 12 


Figure 8-4. Use of READ/DATA to Build An Array 
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Figure 8-5 shows an example of building a 6 x 3 matrix. 


19 DIM ri<6,3> 

ii'0 FUR RUN=U Tu 6 

38 FOR C0L=1 TO 3 

48 N( ROW , COL >=IMT< RNDC 8 }* 1 880 > 

58 NEXT COL : NEXT ROW 

68 FOR R0W=8 TO 6 

70 FOR COL=l TO 3 

80 PRINT M( ROW, COL > 

98 NEXT COL ■ PRINT = NEXT ROW 


Figure 8-5. Building A Matrix 

Note that the words ROW and COLUMN are not BASIC commands, statements, 
functions, or keywords. They are simply variable names used here to designate 
which loop function is first. The program could just as easily have been written 
with X and Y as the variable names. 

CLR Format: CLR 

Example: 200 CLR 

This command clears the memory of all previously dimensioned strings, arrays, 
and matrices so the memory and variable names can be used for other purposes. 
It also clears the values stored in undimensioned variables. If a matrix, string, or 
array is needed after a CLR command, it must be redimensioned with a DIM 
command. 
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GRAPHICS MODES 
AND COMMANDS 


This section describes the Atari BASIC commands and the different graphics 
modes of the ATARI Personal Computer. Using these commands, it is possible to 
create graphics for game, graphics, and patterns. 

The commands to be described in this section are: 

GRAPHICS LOCATE PUT/GET 

COLOR PLOT SETCOLOR 

DRAWTO POSITION XIO 

The PUT/GET and XIO commands explained in this section are special applica- 
tions of the same commands described in Section 5. 

GRAPHICS (GR.) Format: GRAPHICS aexp 

Example: GRAPHICS 2 


This command is used to select one of the nine graphics modes. Table 9-1 sum- 
marizes the nine modes and the characteristics of each. The GRAPHICS com- 
mand automatically opens the screen, S:(the graphics window), as device #6. So 
when printing text in the text window, it is not necessary to specify the device 
code. The aexp must be positive, rounded to the nearest integer. Graphics mode 
0 is a full-screen display while modes 1 through 8 are split screen displays. To 
override the split-screen, add the characters + 16 to the mode number (aexp) in 
the GRAPHICS command. Adding 32 prevents the graphics command from 
clearing the screen. 


To return to graphics mode 0 in Direct mode, press 
and press 


SYSTEM RESET 


or type GR.O 


TABLE 9.1— TABLE OF MODES AND SCREEN FORMATS 


SCREEN FORMAT 





Vert. 

Vert. 

Number 


Gr. 

Mode 

Horiz. 

(Col) 

(Col) 

Of 

RAM 

Mode 

Type 

(Rows) 

Split 

Full 

Colors 

Required 




Screen 

Screen 


(Bytes) 

0 

TEXT 

40 

- 

24 

2 

993 

1 

TEXT 

20 

20 

24 

5 

513 

2 

TEXT 

20 

10 

12 

5 

261 

3 

GRAPHICS 

40 

20 

24 

4 

273 

4 

GRAPHICS 

80 

40 

48 

2 

537 

5 

GRAPHICS 

80 

40 

48 

4 

1017 

6 

GRAPHICS 

160 

80 

96 

2 

2025 

7 

GRAPHICS 

160 

80 

96 

4 

3945 

8 

GRAPHICS 

320 

160 

192 

1/2 

7900 


The following paragraphs describe the nine graphics modes. 
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GRAPHICS 
MODE 0 


GRAPHICS 
MODES 
1 AND 2 


This mode is the 1-color, 2-luminance (brightness) default mode for the ATARI 
Personal Computer. It contains a 24 by 40 character screen matrix. The default 
margin settings at 2 and 39 allow 38 characters per line. Margins may be chang- 
ed by poking LMARGN and RMARGN (82 and 83). See Appendix I. Some systems 
have different margin default settings. The color of the characters is determined 
by the background color. Only the luminance of the characters can be different. 
This full-screen display has a blue display area bordered in black (unless the 
border is specified to be another color). To display characters at a specified loca- 
tion, use one of the following two methods. 


Method 1. 

lineno POSITION aexpl, aexp2 
lineno PRINT sexp 

Method 2 

lineno GR. 0 
lineno POKE 752,1 
lineno COLOR ASC(sexp) 

lineno PLOT aexpl, aexp2 

lineno GOTO lineno 


Puts cursor at location 
specified by aexpl and aexpZ. 

Specifies graphics mode. 
Suppresses cursor. 

Specifies character to be 
printed. 

Specifies where to print 
character. 

Start loop to prevent READY 
from being printed. (GOTO 
same lineno.) 


Press 

loop. 


BREAK 


to terminate 


GRAPHICS 0 is also used as a clear screen command either in Direct mode or 
Deferred mode. It terminates any previously selected graphics mode and 
returns the screen to the default mode (GRAPHICS 0). 


As defined in Table 9-1, these two 5-color modes are Text modes. However, they 
are both split-screen (see Figure 9-1) modes. Characters printed in Graphics 
mode 1 are twice the width of those printed in Graphics 0, but are the same 
height. Characters printed in Graphics mode 2 are twice the width and height 
of those in Graphics mode 0. In the split-screen mode, a PRINT command is used 
to display characters in either the text window or the graphics window. To 
print characters in the graphics window, specify device #6 after the PRINT com- 
mand. 

Example: 100 GR. 1 

110 PRINT#6;“ATARI” 

The default colors depend on the type of character input. Table 9-2 defines the 
default color and color register used for each type. 


Table 9-2. Default Colors for Specific Input Types 


Character Type 

Color Register 

Default Color 

Upper case alphabetical 

0 

Orange 

Lower case alphabetical 

1 

Light Green 

Inverse upper case alphabetical 

2 

Dark Blue 

Inverse lower case alphabetical 

3 

Red 

Numbers 

0 

Orange 

Inverse numbers 2 

Note: See SETCOLOR to change character colors. 

Dark Blue 
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Unless otherwise specified, all characters are displayed in upper case non- 
inverse form. To print lower case letters and graphics characters, use a POKE 
756,226. To return to upper case, use POKE 756,224. 

In graphics modes 1 and 2, there is no inverse video, but it is possible to get all 
the rest of the characters in four different colors (see end of section). 

(X = 0) 

(Y = 0) 



Figure 9-1. Split-Screen Display For Graphics Modes 1 and 2 


The X and Y coordinates start at 0 (upper left of screen). The maximum values 
are the numbers of rows and columns minus 1 (see Table 9-1). 

This split-screen configuration can be changed to a full screen display by adding 
the characters + 16 to the mode number. 

Example: GRAPHICS 1 + 16 


GRAPHICS 
MODES 
3, 5, AND 7 


These three 4-color graphics modes are also split-screen displays in their default 
state, but may be changed to full screen by adding + 16 to the mode number. 
Modes 3, 5, and 7 are alike except that modes 5 and 7 use more points (pixels) in 
plotting, drawing, and positioning the cursor; the points are smaller, thereby 
giving a much higher resolution. 


GRAPHICS 
MODES 
4 AND 6 


GRAPHICS 
MODE 8 


These two 2-color graphics modes are split-screen displays and can display in 
only two colors while the other modes can display 4 and 5 colors. The advantage 
of a two-color mode is that it requires less RAM space (see Table 9-1). Therefore, 
it is used when only two colors are needed and RAM is getting crowded. These 
two modes also have a higher resolution which means smaller points than 
Graphics mode 3. 

This graphics mode gives the highest resolution of all the other modes. As it 
takes a lot of RAM to obtain this kind of resolution, it can only accomodate a 
maximum of one color and two different luminances. 
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COLOR (C.) 


DRAWTO (DR.) 


LOCATE (LOC.) 


Format: COLOR aexp 

Examples: 110 COLOR ASC(“A”) 

110 COLOR 3 

The value of the expression in the COLOR statement determines the data to be 
stored in the display memory for all subsequent PLOT and DRAWTO com- 
mands until the next COLOR statement is executed. The value must be positive 
and is usually an integer from 0 through 255. Non-integers are rounded to the 
nearest integer. The graphics display hardware interprets this data in different 
ways in the different graphics modes. In text modes 0 through 2, the number 
can be from 0 through 255 (8 bits) and determines the character to be displayed 
and its color. (The two most significant bits determine the color. This is why on- 
ly 64 different characters are available in these modes instead of the full 
256-character set.) 

Tables 9-6 and 9-7 at the end of this section illustrate the internal character set 
and the character/color assignment. Table 9-2 is a simplified table which allows 
easy generation of some of the colors. For example, COLOR ASC(“A”)s PLOT 
5,5 will display an orange A character in graphics modes 1 or 2 at location 5,5. 

Graphics modes 3 through 8 are not text modes, so the data stored in the display 
RAM simply determines the color of each pixel. Two-color or two-luminance 
modes require either 0 or 1 (1-bit) and four-color modes require 0, 1, 2, or 3. (The 
expression in the COLOR statement may have a value greater than 3, but only 
one or two bits will be used.) The actual color which is displayed depends on the 
value in the color register which corresponds to the data of 0, 1, 2, or 3 in the 
particular graphics mode being used. This may be determined by looking in 
Table 9-5, which gives the default colors and the corresponding register 
numbers. Colors may be changed by using SETCOLOR. 

Note that when BASIC is first powered up, the color data is 0, and when a 
GRAPHICS command (without +32) is executed, all of the pixels are set to 0. 
Therefore, nothing seems to happen to PLOT and DRAWTO in GRAPHICS 3 
through 7 when no COLOR statement has been executed. Correct by doing a 
COLOR 1 first. 


Format: DRAWTO aexpl, aexp2 

Example: 100 DRAWTO 10, 8 

This statement causes a line to be drawn from the last point displayed by a PLOT 
(see PLOT) to the location specified by aexpl and aexp2. The first expression 
represents the X coordinate and the second represents the Y-coordinate (see 
Figure 9-1). The color of the line is the same color as the point displayed by the 
PLOT. 

Format: LOCATE aexpl, aexp2, var 

Example: 150 LOCATE 12, 15, X 

This command positions the invisible graphics cursor at the specified location in 
the graphics window, retrieves the data at that pixel, and stores it in the 
specified arithmetic variable. This gives a number from 0 to 255 for Graphics 
modes 0 through 2; 0 or 1 for the 2-color graphics modes; and 0, 1, 2, or 3 for the 
4-color modes. The two arithmetic expressions specify the X and Y coordinates 
of the point. LOCATE is equivalent to: 

POSITION aexpl, aexp2:GET #6,avar 


48 Graphic Modes and Commands 



PLOT (PL.) 


POSITION (POS.) 


PUT/GET 

(PU./GE.) 


Doing a PRINT after a LOCATE or GET from the screen may cause the data in 
the pixel which was examined to be modified. This problem is avoided by 
repositioning the cursor and putting the data that was read, back into the pixel 
before doing the PRINT. The following program illustrates the use of the 
LOCATE command. 


10 GRAPHICS 3+16 
20 COLOR i 
30 SETCOLOR 2.. 10,3 
40 PLOT 10,15 
50 DR A WTO 15,15 
60 LOCATE 12, 15, K 
70 PRINT X 


Figure 9-2 . Example Program Using LOCATE 

On execution, the program prints the data (1) determined by the COLOR state- 
ment which was stored in pixel 12, 15. 

Format: PLOT aexpl, aexp2 

Example: 100 PLOT 5,5 

The PLOT command is used in graphics modes 3 through 8 to display a point in 
the graphics window. The aexpl specifies the X-coordinate and the aexp2 the 
Y-coordinate. The color of the plotted point is determined by the hue and 
luminance in the color register from the last COLOR statement executed. To 
change this color register, and the color of the plotted point, use SET- 
COLOR. Points that can be plotted on the screen are dependent on the graphics 
mode being used. The range of points begins at 1 and extends to one less than 
the total number of rows (X-coordinate) or columns (Y-coordinate) shown in 
Table 9-1. 

Format: POSITION aexpl, aexp2 

Example: 100 POSITION 8, 12 

The POSITION statement is used to place the invisible graphics window cursor 
at a specified location on the screen (usually precedes a PRINT statement). This 
statement can be used in all modes. Note that the cursor does not actually move 
until an I/O command which involves the screen is issued. 

Formats: PUT #aexp, aexp 

GET #aexp, avar 

Examples: 100 PUT #6, ASC(“A”) 

200 GET #1, X 

In graphics work, PUT is used to output data to the screen display. This state- 
ment works hand-in-hand with the POSITION statement. After a PUT (or GET), 
the cursor is moved to the next location on the screen. Doing a PUT to device #6 
causes the one-byte input (second aexp) to be displayed at the cursor position. 
The byte is either an ATASCII code byte for a particular character (modes 0-2) or 
the color data (modes 3-8). 

GET is used to input the code byte of the character displayed at the cursor posi- 
tion, into the specified arithmetic variable. The values used in PUT and GET cor- 
respond to the values in the COLOR statement. (PRINT and INPUT may also be 
used.) 
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Note: Doing a PRINT after a LOCATE or GET from the screen may cause the 
data in the pixel which was examined to be modified. To avoid this problem, 
reposition the cursor and put the data that was read, back into the pixel before 
doing the PRINT. 

SETCOLOR (SE.) Format: SETCOLOR aexpl, aexp2, aexp3 

Example: 100 SETCOLOR 0, 1, 4 

This statement is used to choose the particular hue and luminance to be stored 
in the specified color register. The parameters of the SETCOLOR statement are 
defined below: 

aexpl = Color register (0-4 depending on graphics mode) 
aexp2 = Color hue number (0-15. See Table 9-3) 

aexp3 = Color luminance (must be an even number between 0 and 14; the 
higher the number, the brighter the display. 14 is almost pure 
white.) 


TABLE 9.3— THE ATARI HUE (SETCOLOR COMMAND) 
NUMBERS AND COLORS 

COLORS 

SETCOLOR (aexp2) NUMBERS 

GRAY 

0 

LIGHT ORANGE (GOLD) 

1 

ORANGE 

2 

RED-ORANGE 

3 

PINK 

4 

PURPLE-BLUE 

6 

BLUE 

7 

BLUE 

8 

LIGHT BLUE 

9 

TURQUOISE 

10 

GREEN-BLUE 

11 

GREEN 

12 

YELLOW-GREEN 

13 

ORANGE-GREEN 

14 

LIGHT ORANGE 

15 

Note: Colors will vary with type and adjustment of TV or monitor used. 


The ATARI display hardware contains five color registers, numbered 
from 0 through 4. The Operating System (OS) has five RAM locations (COLORO 
through COLOR4, see Appendix I - Memory Locations) where it keeps track of 
the current colors. The SETCOLOR statement is used to change the values in 
these RAM locations. (The OS transfers these values to the hardware registers 
every television frame.) The SETCOLOR statement requires a value from 0 to 4 
to specify a color register. The COLOR statement uses different numbers 
because it specifies data which only indirectly corresponds to a color register. 
This can be confusing, so careful experimentation and study of the various 
tables in this section is advised. 

No SETCOLOR commands are needed if the default set of five colors is used. 
Although 128 different color-luminance combinations are possible, not more 
than five can be displayed at any one time. The purpose of the color registers 
and SETCOLOR statement is to specify these five colors. 
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TABLE 9.4— TABLE OF SETCOLOR “DEFAULT” COLORS* 

Setcolor 
(Color Register) 

Defaults To 
Color 

Luminance 

Actual Color 

0 

2 

8 

ORANGE 

1 

12 

10 

GREEN 

2 

9 

4 

DARK BLUE 

3 

4 

6 

PINK OR RED 

4 

0 

0 

BLACK 

* “DEFAULT” occurs 

if not SETCOLOR statement is used. 


Note: Colors may vary depending upon the television monitor type, condition, 
and adjustment. 


A program illustrating Graphics mode 3 and the commands explained so far in 
this section is shown below: 


18 GRAPHICS 3 


26 

SETC 

3L0R 


0.. £.■ 8 : COLOR 1 


39 

PLOT 

4 “7 

i r , 

1 

• DRAWTO 

17, 18 -DRAWTO 

9, 18 

40 

PLOT 

19, 

4 

1 

: DRAWTO 

19, IS 


50 

PLOT 

20.. 

4 

: DRAWTU 

28, 18 


60 

PLOT 

22, 

1 

: DRAW i u 

, 1 8 : DRAWT 0 

30 j lb 

70 

POKE 

-?CT-“ 

i Jcl 


i 



80 

PRIM' 

T : PR 

? r.jT 11 

hT hK I PERoUr 

iAL COMP 


LITERS !i 
90 i jOT u yy 


The SETCOLOR and COLOR statements set the color of the points to be plotted 
(see Table 9.5). The SETCOLOR command loads color register 0 with hue 2 
(orange) and a luminance of 8 (“normal”). The next 4 lines plot the points to be 
displayed. Line 90 suppresses the cursor and line 100 prints the string expres- 
sion ATARI PERSONAL COMPUTERS in the text window (6 spaces in). 


Note that the background color was never set because the default is the desired 
color (black). 


If the program is executed, it will print the Atari logo in the graphics window 
and the string expression in the text window as in Figure 9-3. 
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Figure 9-3. Atari Logo Program Execution 


Y-AXIS POINTS (ROWS) 
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X-AXIS POINTS (COLUMNS) 



TABLE 9.5— MODE, SETCOLOR, COLOR TABLE 


DESCRIPTION AND COMMENTS 

Character luminance (same color as background) 
Background 

Border 

Character 

Character 

Character 

Character 

Background, Border 

Graphics point 

Graphics point 

Graphics point 

Graphics point (background default), Border 

Graphics point 

Graphics point (background default), Border 

Graphics point luminance (same color as background) 
Graphics point (background default) 

Border 

Color 

(aexp) 

COLOR data 
actually 
determines 
character to 
be plotted 

COLOR data 
actually determines 
character to be 
plotted 

tH cm co i O 

rH i i i 

■ t-h O 1 1 

SETCOLOR 

(aexpl) 

Color 

Register No. 

O H CO ^ 

O tH OJ CO ^ 

O H cm co ^ 

O n CM CO O 

O T-( cm CO ^ 

Mode or 
Condition 

MODE 0 and 
ALL TEXT 
WINDOWS 

MODES 1 
and 

2 

(Text Modes) 

MODES 3, 5, 
and 7 
(Four-color 
Modes) 

MODES 4 
and 6 
(Two-color 
Modes) 

4 

MODE 8 
(1 Color 

2 Luminances) 

Default 

Colors 

LIGHT BLUE 
DARK BLUE 

BLACK 

ORANGE 
LIGHT GREEN 
DARK BLUE 

RED 

BLACK 

ORANGE 
LIGHT GREEN 
DARK BLUE 

BLACK 

ORANGE 

BLACK 

LIGHT GREEN 
DARK BLUE 

BLACK 
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XIO (X.) 
SPECIAL FILL 
APPLICATION 


Format: XIO 18, #aexp, aexpl, aexp2, filespec 

Example: 100 XIO 18, #6, 0, 0, “S:” 


This special application of the XIO statement fills an area on the screen between 
plotted points and lines with a non-zero color value. Dummy variables (0) are 
used for aexpl and aexp2. 


The following steps illustrate the fill process: 


1. PLOT bottom right corner (point 1). 

2. DRAWTO upper right corner (point 2). This outlines the right edge of the 
area to be filled. 

3. DRAWTO upper left corner (point 3). 

4. POSITION cursor at lower left corner (point 4). 

5. POKE address 765 with the fill color data (1, 2, or 3). 

6. This method is used to fill each horizontal line from top to bottom of the spe- 

cified area. The fill starts at the left and proceeds across the line to the right 
until it reaches a pixel which contains non-zero data (will wraparound if 
necessary). This means that fill cannot be used to change an area which has 
been filled in with a non-zero value, as the fill will stop. The fill command 
will go into an infinite loop if a fill with zero (0) data is attempted on a line 
which has no non-zero pixels. ■ or can be used to stop the 

fill if this happens. 


The following program creates a shape and fills it with a data (color) of 3. Note 
that the XIO command draws in the lines of the left and bottom of the figure. 


10 GRAPHICS 5+16 
20 COLOR 3 
38 PLOT 70,45 
40 DRAWTO 50.* 18 
50 DRAWTO 3u, iy 
60 POSITION 18,45 
70 POKE 765,3 
80 XIO 18, #6, 8, 8, H S : u 
90 GOTO 90 


Figure 9-4. Example “FILL” Program 


Assigning Colors To Characters In Text Modes 1 and 2 

This procedure describes the method of assigning colors to the Atari character 
set. First, look up the character number in Table 9-6. Then, see Table 9-7 to get 
the conversion of that number required to assign a color register to it. 

Example: Assign SETCOLOR 0 to lower case “r” in mode 2 
whose color is determined by register 0. 

1. In Table 9-6, find the column and number for cc r” (114-column 4). 

2. Using Table 9-7, locate column 4. Conversion is the character number minus 
32 (114 - 32 = 82). 
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Table 9.6— INTERNAL CHARACTER SET 
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In mode 0 these characters must be preceded with an escape, CHR$(27), to be printed. 



































































































Table 9.7— CHARACTER/COLOR ASSIGNMENT 


Conversion 1 

Conversion 2 

Conversion 3 

Conversion 4 

MODE 0 


#+32 

# + 32 

#-32 

NONE 


POKE 756,224 

POKE 756,226 

MODE 1 

SETCOLOR 0 

- $ 32 

# + 32 

#-32 

#-32 

OR 

SETCOLOR 1 

NONE 

# + 64 

#-64 

NONE 

MODE 2 

SETCOLOR 2 

#+160 

#+160 

# + 96 

# + 96 


SETCOLOR 3 

#+128 

#+192 

# + 64 

#+128 


2. Luminance controlled by SETCOLOR 1, 0, LUM. 


3. POKE the Character Base Address (CHBAS) with 226 to specify lower case let- 
ters or special graphics characters; e.g., 

POKE 756,226 
or 

CHBAS = 756 
POKE CHBAS, 226 


To return to upper case letters, numbers, and punctuation marks, POKE CHBAS 
with 224. 

4. A PRINT statement using the converted number (82) assigns the lower case 
“r” to SETCOLOR 0 in mode 2 (see Table 9-5). 

Graphic Control Characters 

These characters are produced when the Q39 key is pressed with the 
alphabetic keys shown on back cover. These characters can be used to draw 
design, pictures, etc., in mode 0 and in modes 1 and 2 if CHBAS is changed. 
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SOUND (SO.) 


SOUNDS AND GAME 
CONTROLLERS 


This section describes the statement used to generate musical notes and sounds 
through the audio system of the television monitor. Up to four different sounds 
can be “played” simultaneously creating harmony. This SOUND statement can 
also be used to simulate explosions, whistles, and other interesting sound ef- 
fects. The other commands described in this section deal with the functions 
used to manipulate the keyboard, joystick, and paddle controllers. These func- 
tions allow these controllers to be plugged in and used in BASIC programs for 
games, etc. 

The command and functions covered in this section are: 

SOUND PADDLE STICK 

PTRIG STRIG 


Format: SOUND aexpl, aexp2, aexp3, aexp4 

Example: 100 SOUND 2, 204, 10, 12 

The SOUND statement causes the specified note to begin playing as soon as the 
statement is executed. The note will continue playing until the program en- 
counters another SOUND statement with the same aexpl or an END statement. 
This command can be used in either Direct or Deferred modes. 


The SOUND parameters are described as follows: 

aexpl = Voice. Can be 0-3, but each voice requires a separate SOUND state- 
ment. 

aexp2 = Pitch. Can be any number between 0-255. The larger the number, 
the lower the pitch. Table 10-1 defines the pitch numbers for the 
various musical notes ranging from two octaves above middle C to 
one octave below middle C. 

aexp3 = Distortion. Can be even numbers between 0-14. Used in creating 
sound effects. A 10 is used to created a “pure” tone whereas a 12 
gives an interesting buzzer sound. A buzzing sound (like engines at 
a race track) can be produced using two separate SOUND commands 
with the distortion value (aexp3) alternating between 0 and 1. A 
value of 1 is used to force output to the speaker using the specified 
volume (see aexp4). The rest of the numbers are used for other 
special effects, noise generation, and experimental use. 

aexp4 = Volume control. Can be between 1 and 15. Using a 1 creates a sound 
barely audible whereas a 15 is loud. A value of 8 is considered nor- 
mal. If more than 1 sound statement is being used, the total volume 
should not exceed 32. This will create an unpleasant “clipped” tone. 
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Using the note values in Table 10-1, the following example demonstrates how to 
write a program that will “play” the C scale. 

TABLE 10.1. TABLE OF PITCH VALUES FOR THE MUSICAL 

NOTES 


HIGH C 29 

NOTES B 31 

A# or B b 33 

A 35 

G# or Ab 37 

G 40 

F# or Gb 42 

F 45 

E 47 

D# or E 50 

D 53 

C# or Db 57 

C 60 

B 64 

A # or B 68 

A 72 

G# or Ab 76 

G 81 

F# or Gb 85 

F 91 

E 96 

D# or Eb 102 

D 108 

C# or Db 114 

MIDDLE C C 121 

B 128 

A# or Bb 136 

A 144 

G# or Ab 153 

G 162 

F# G b 173 

F 182 

LOW NOTES D 193 

D# or lb 204 

, D 217 

* C# or Db 230 

C 243 


10 READ A 

20 IF A=25S THEN END 
30 SOUND 8,h,18,18 
40 FOR W=i TO 400: NEXT M 
50 PRINT A 
60 GOTO 10 
70 END 


80 DATA 29,31,35,40,45,47,53,68,64/ 
,91,96,108,121 

90 DAT A 1 2o , 144, 1 62 , 1 6d , 1 96 ,217, 243 


» t" ^ 

. , o i 


56 


Figure 10-1 . Musical Scale Program 


Note that the DATA statement in line 80 ends with a 256, which is outside of the 
designated range. The 256 is used as an end-of-data marker. 
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GAME 

CONTROLLER 

FUNCTIONS 


PADDLE 


PTRIG 


STICK 


Figure 10-2 is an illustration of the three controllers used with the Atari Per- 
sonal Computers. The controllers can be attached directly to the Atari Per- 
sonal Computer or to external mechanical devices so that outside events can be 
fed directly to the computer for processing and control purposes. 



Figure 10-2. Game Controllers 


Format : P A DDLE(aexp) 

Example: PRINT PADDLE® 

This function returns the status of a particular numbered controller. The paddle 
controllers are numbered 0-7 from left to right. This function can be used with 
other functions or commands to “cause” further actions like sound, graphics 
controls, etc. For example, the statement IF PADDLE(3) = 14 THEN PRINT 
“PADDLE ACTIVE.” Note that the PADDLE function returns a number bet- 
ween 1 and 228, with the number increasing in size as the knob on the con- 
troller is rotated counterclockwise (turned to the left). 


Format : PTRIG(aexp) 

Example: 100 IF PTRIG® = 0 THEN PRINT “MISSILES FIRED!” 

The PTRIG function returns a status of 0 if the trigger button of the designated 
controller is pressed. Otherwise, it returns a value of 1. The aexp must be a 
number between 0 and 7 as it designates the controller. 


Format : STICK(aexp) 

Example: 100 PRINT STICK® 

This function works exactly the same way as the PADDLE command, but can be 
used with the joystick controller. The joystick controllers are numbered from 
0-3 from left to right. 

Controller 1 = STICK® 

Controller 2 = STICK® 

Controller 3 = STICK® 

Controller 4 = STICK® 

Figure 10-3 shows the numbers that will be returned when the joystick con- 
troller is moved in any direction. 
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STRIG 


14 



Figure 10-3. Joystick Controller Movement 


Format : STRIG(aexp) 

Example: 100 IF STRIG® = 0 THEN PRINT “FIRE TORPEDO” 

The STRIG function works the same way as the PTRIG function. It can be used 
with both the joystick and keyboard controllers. 
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MEMORY 

CONSERVATION 


ADVANCED PROGRAMMING 

TECHNIQUES 


This section includes hints on increasing programming efficiency, conserving 
memory, and combining machine language programs with Atari BASIC pro- 
grams. This section does not include an instruction set for the 6502 micro- 
processor chip nor does it give instructions on programming in machine 
language. An additional purchase of the Atari Assembler Editor cartridge* and 
a careful study of Atari’s Assembler Editor Manual are strongly recommended. 


These hints give ways of conserving memory. Some of these methods make pro- 
grams less readable and harder to modify, but there are cases where this is 
necessary due to memory limitations. 


1. In many small computers, eliminating blank spaces between words and 
characters as they are typed into the keyboard will save memory. This is not 
true of the ATARI Personal Computer System, which removes extra spaces. 
Statements are always displayed the same regardless of how many spaces 
were used on program entry. Spaces should be used (just as in typing on a 
conventional typewriter) between successive keywords and between 
keywords and variable names. Here is an example: 


10 IF A = 5 THEN PRINT A 


Note the space between IF and A and between THEN and PRINT. In most 
cases, a statement will be interpreted correctly by the computer even if all 
spaces are left out, but this is not always true. Use conventional spacing. 


2. Each new line number represents the beginning of what is called a new 
“logical line”. Each logical line takes 6 bytes of “overhead”, whether it is 
used to full capacity or not. Adding an additional BASIC statement by using a 
colon (:) to separate each pair of statements on the same line takes only 3 
bytes. 


*Available late 1980. 
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If you need to save memory, avoid programs like this: 


10 X=Y+1 
20 Y=Y+1 
30 Z=X+Y 
40 PRINT Z 
50 GOTO 50 


and consolidate lines like this: 


10 X=X+ 1 : Y=Y+ 1 : Z=X+Y : PR I NT Z^GQTO 10 


This consolidation saves 12 bytes. 


3. Variables and constants should be “managed” for savings, too. Each time a 
constant (4,5,16,3.14159, etc.) is used, it takes 7 bytes. Defining a new 
variable requires 8 bytes plus the length of the variable name (in characters). 
But each time it is used after being defined, it takes only 1 byte, regardless of 
its length. Thus, if a constant (such as 3.14159) is used more than once or 
twice in a program, it should be defined as a variable, and the variable name 
used throughout the program. For example: 


10 PI=3. 14159 

29 PRIHT "AREA OF A CIRCLE IS THE RADIUS 
SQUARED TIMES ";PI 


4. Literal strings require 2 bytes overhead and 1 byte for each character 
(including all spaces) in the string. 


5. String variables take 9 bytes each plus the length of the variable name 
(including spaces) plus the space eaten up by the DIM statement plus the size 
of the string itself (1 byte per character, including spaces) when it is defined. 
Obviously, the use of string variables is very costly in terms of RAM. 


6. Definition of a new matrix requires 15 bytes plus the length of the matrix 
variable name plus the space needed for the DIM statement plus 6 times the 
size of the matrix (product of the number of rows and the number of col- 
umns). Thus, a 25 row by 4 column matrix would require 15 + approxi- 
mately 3 (for variable name) + approximately 10 (for the DIM statement) + 6 
times 100 (the matrix size), or about 630 bytes. 
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7. Each character after REM takes one byte of memory. Remarks are helpful to 
people trying to understand a program, but sometimes it is necessary to 
remove remark statements to save memory. 


8. Subroutines can save memory because one subroutine and several short calls 
take less memory than duplicating the code several times. On the other 
hand, a subroutine that is only called once takes extra bytes for the GOSUB 
and RETURN statements. 


9. Parentheses take one byte each. Extra parentheses are a good idea in some 
cases if they make an expression more understandable to the programmer. 
However, removing unnecessary parentheses and relying on operator 
precedence will same a few bytes. 


PROGRAMMING 
IN MACHINE 
LANGUAGE 


Machine language is written entirely in binary code. The ATARI Personal Com- 
puter contains a 6502 microprocessor and it is possible to call 6502 machine code 
subroutines from BASIC using the USR function. Short routines may then be 
entered into a program by hand assembly (if necessary). 


Before it returns to BASIC, the assembly language routine must do a pull ac- 
cumulator (PLA) instruction to remove the number (N) of input arguments off 
the stack. If this number is not 0, then all of the input arguments must be pop- 
ped off the stack also using PLA. (See Figure 6-1). 


The subroutine should end by placing the low byte of its result in location 212 
(decimal), and then return to BASIC using an RTS (Return from Subroutine) in- 
struction. The BASIC interpreter will convert the 2-byte binary number stored 
in locations 212 and 213 into an integer between 0 and 65535 in floating-point 
format to obtain the value returned by the USR function. 


The ADR function may be used to pass data that is stored in arrays or strings to a 
subroutine in machine language. Use the ADR function to get the address of the 
array or string, and then use this address as one of the USR input arguments. 


The following program, Hexcode Loader, provides the means of entering hexa- 
decimal codes, converting each hexadecimal number to decimal, and storing the 
decimal number into an array. The array is then executed as an assembly 
language subroutine. (An array is used to allocate space in memory for the 
routine.) 
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1. To use this program, first enter it. After entering it, save this program on 
disk or cassette for future use. 


10 GRAPHICS 8= PRINT "HEXCOOE LOADER PROG 
RAM": PRINT 

20 REM STORES DECIMAL EQUIUALENTS IN ARR- 
AY A, OUTPUTS IN PRINTED 'DATA STATEMENT 
S' AT 

21 REM LINE NUMBER 1500. 

30 REM USER THEN PLACES CURSOR ON PRINTE 
D OUTPUT LINE, HITS “RETURN'S AND ENTERS 

31 REM REST OF BASIC PROGRAM INCLUDING U 
SR STATEMENT. 

40 DIM AC 50 >, HEX*C 5 > 

50 REM INPUT, CONVERSION, STORAGE OF DATA 


60 N=0: PRINT “ENTER 1 HEX CODE. IF LAST 
ONE IS IN, ENTER 'DONE'."; 

70 INPUT HEX* 

80 IF HEX*="D0NE" THEN N=339-G0T0 130 
90 FOR 1=1 TO LENC HEX* > 

100 IF HEX$CI,IX="9" THEN N=NS16+UALCHE 
X$C I , I > > = GOTO 120 

110 N=N#16+ASCC HEX*C I, I >>-ASCC "A" >+10 

120 NEXT I 

130 PRINT N : C=C+ 1 

140 ACC)=N 

150 IF N< >939 THEN GOTO 60 

190 REM F-RINT OUT DATA LINE AT 1500 

208 GRAPHICS 0: PRINT "1500 DATA'S 

210 C=0 

220 C=C+1 

230 IF ACC 1=339 THEN PRINT "993": STOP 
240 PRINT ACC); ", 'S 
250 AC 0=0 
260 GOTO 220 

300 F-RINT "PUT CORRECT NUMBER OF HEX BYT 
ES IN LINE 1080. "-STOP : REM TRAP LINE 
999 REM tt EXECUTION MODULE U 
1080 CLR :B*vTES=0 

1010 TRAP 300: DIM E*C 1 ), EC I NTC BYTES/6 >+l 

) 

1030 FOR 1=1 TO BYTES 

1040 READ A= IF A>255 THEN GOTO 1060 

1050 POKE ADRCE*)+I,A 

1060 NEXT I 

1070 REM BASIC PART OF USER'S PROGRAM FO 
LLOWS 


Figure 11-1 . Hexcode Loader Input Program 


64 Advanced Programming Techniques 



2. Now add the BASIC language part of your program starting at line 1080 in- 
cluding the USR function that calls the machine language subroutine. (See 
example below.) 


3. Count the total number of hex codes to be entered and enter this number on 
line 1000 when requested. If another number is already entered, simply 
replace it. 


4. Run the program and enter the hexadecimal codes of the machine level 
subroutine press ing after each entry. After the last entry, type 

DONE and press tSJJUJJI . 


5. Now the DATA line (1500) displays on the screen. It will not be entered into 
the program until the cursor is moved to the DATA line and 
pressed. 


6. Add a program line 5 GOTO 1000 to bypass the hexcode loader (or delete the 
hexcode loader through line 260). Now save the completed program by 
using CSAVE or SAVE. It is important to do this before executing the part of 
the program containing the USR call. A mistake in a machine language 
routine may cause the system to crash. If the system does hang up, press 
. If the system doesn’t respond, turn power off and on again, 
reload the program, and correct it. 


Note: This method only works with relocatable machine language routines. 


The following two sample programs can each be entered into the Hexcode 
Loader program. The first program prints NOTHING IS MOVING while the 
machine program changes the colors. The second sample program displays a 
BASIC graphics design, then changes colors. 


1088 GRAPHICS 1+16 
1098 FOR 1=1 TO 6 

1100 PRINT #6; "noth ins is niovins! " 
1110 PRINT #6; "NOTHING IS flOUING!" 
1128 PRINT #6.; " not Hi ns is iriouins!" 
1130 PRINT #6; "NOTHING IS flOUING !" 
1140 NEXT I 
1 150 Q=USR< ADR< El )+ 1 > 

1168 FOR 1=1 TO 25 : NEXT I = GOTO 1150 


After entering this program, check that line 1000 reads: 

1000 CLR:BYTES = 21 


Type RUN 


RETURN 
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Now enter the hexadecimal codes as shown column by column. 


68 

2 

A2 

E8 

0 

E0 

AC 

3 

C4 

90 

2 

F5 

BD 

8C 

C5 

C 7 

2 

2 

9D 

60 

C4 



When completed, type DONE and press i;iwi; 
last entry (999) on the DATA line and press | 


| . Now place the cursor after the 


’ Now run the program by typing GOTO 1000 and pressing £££23113 > or if line 5 
has been added, type RUN l:UJII:l?l . Press JTT7TW to stop program and delete line 
5. 


The second program, which follows, should be entered in place of the 

NOTHING IS MOVING program. Be sure to check the BYTES = count in 

line 1000. Follow steps 2 through 6. 

1080 GRAPHICS 7+16 
1090 SET COLOR 0,9,4 
1100 SETCOLOR 1,9,8 
1110 SETCOLOR 2,9,4 
1120 CR=1 

1130 FOR X=0 TO 159 
1140 COLOR INT(CR) 

1150 PLOT 38,0 
1160 DRAHTO X,95 
1170 CR=CR+0 . 125 
1180 IF CR=4 THEN CR=1 
1190 NEXT X 
1200 X=USR< A0R< E$ >+ 1 ) 

1210 FOR 1=1 TO 15= NEXT I 
1220 GOTO 1200 


Type RUN 


RETURN 


Enter the hexadecimal codes for this program column by column. 


68 

2 

A2 

E8 

0 

EO 

AC 

2 

C4 

90 

2 

F5 

BD 

8C 

C5 

C6 

2 

2 

9D 

60 

C4 



BYTES = 21 
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. Now place the cursor after the 


When completed, type DONE and press EH7TT 
last entry (999) on the DATA line and press 

Now run the program by typing GOTO 1000 and pressing B|jgnO,or add line 5 
GOTO 1000 and type RUN QSZSH3* Press to stop program and delete line 

5. 


Figure 11-2 illustrates an assembler subroutine used to rotate colors which 
might prove useful. It is included here for the information of the user. 


Assembler Subroutine to Rotate Colors.. 


Address 

Object 

Code 

Line 

No. 

Label 

i 

Mnemonic Data 




0100 




Routine to rotate COLOR data 



0110 




From one register to another. 



0120 




4 colors are rotated. 



0130 







0140 




Operating system address 

02C4 


0150 




COLOR 0 = $02C4 

02C5 


0160 




COLOR 1 = $02C5 

02C6 


0170 




COLOR 2 = $02C6 

02C7 


0175 




COLOR 3 = $02C7 



0180 




j 



0190 


* = 

$6000 

Machine program starting address* 

6000 

68 

0200 


PLA 


Pop stack (See Chapter 4) 

6001 

A200 

0210 


LDX 

#0 

Zero the X register 

6003 

ACC402 

0220 


LDY 

COLORO 

Save COLOR 0 

6006 

BDC502 

0230 

LOOP 

LDA 

COLORl,X 


6009 

9DC402 

0240 


STA 

COLORO,X 


600C 

E8 

0250 


INX 


Increment the X register (add one) 

600D 

E002 

0260 


CPX 

#3 

Compare contents of X register 







with 2 

600F 

90F5 

0270 


BCC 

LOOP 

Loop if X register contents are 







less than 2 

6011 

8CC602 

0280 


STY 

COLOR3 

Save COLOR 0 in COLOR 3 

6014 

60 

0290 


RTS 


Return from machine level sub- 







routine 

Assembler 


This Portion is Source Information Programmer Enters 

Prints This 



Using Atari Assembler Cartridge 


# Indicates data (source) 

* Routine is relocatable 

$ Indicates a hexadecimal number 


Figure 11-2 . Assembler Subroutine To Rotate Colors 
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APPENDIX A 


ALPHABETICAL DIRECTORY 
OF BASIC RESERVED WORDS 


Note: The period is mandatory after all abbreviated keywords. 


RESERVED 

WORD: 

ABBREVIATION: 

BRIEF SUMMARY 

OF BASIC STATEMENT 

ABS 


Function returns absolute value (unsigned) of the 
variable or expression. 

ADR 


Function returns memory address of a string. 

AND 


Logical operator: Expression is true only if both subex- 
pressions joined by AND are true. 

ASC 


String function returns the numeric value of a single 
string character. 

ATN 


Function returns the arctangent of a number or expres- 
sion in radians or degrees. 

BYE 

B. 

Exit from BASIC and return to the resident operating 
system or console processor. 

CLOAD 

CLOA. 

Loads data from Program Recorder into RAM. 

CHR$ 


String function returns a single string byte equivalent 
to a numeric value between 0 and 255 in ATASCII code. 

CLOG 


Function returns the base 10 logarithm of an expres- 
sion. 

CLOSE 

CL. 

I/O statement used to close a file at the conclusion of I/O 
operations. 

CLR 


The opposite of DIM: Undimensions all strings; 
matrices. 

COLOR 

C. 

Chooses color register to be used in color graphics 
work. 

COM 


Same as DIM. 

CONT 

CON. 

Continue. Causes a program to restart execution on the 
next line following use of the i'TDJM key or encounter- 
ing a STOP. 

COS 


Function returns the cosine of the variable or expres- 
sion (degrees or radians). 

CSAVE 


Outputs data from RAM to the Program Recorder for 
tape storage. 
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RESERVED 

WORD: 


ABBREVIATION: 


BRIEF SUMMARY 
OF BASIC STATEMENT 


DATA 

i 

D. 

Part of READ/DATA combination. Used to identify the 
succeeding items (which must be separated by commas) 
as individual data items. 

DEG 

DE. 

Statement DEG tells computer to perform 
trigonometric functions in degrees instead of radians. 
(Default in radians.) 

DIM 

DI. 

Reserves the specified amount of memory for matrix, 
array, or string. All string variables, arrays, matrices 
must be dimensioned with a DIM statement. 

DOS 

DO. 

Reserved word for disk operators. Causes the menu to 
be displayed. (See DOS Manual.) 

DRAWTO 

DR. 

Draws a straight line between a plotted point and 
specified point. 

END 

j 

Stops program execution; closes files; turns off sounds. 
Program may be restarted using CONT. (Note: END 
may be used more than once in a program.) 

ENTER 

E. 

I/O command used to store data or programs in un- 
tokenized (source) form. 

EXP 


Function returns e (2.7182818) raised to the specified 
power. 

FOR 

F. 

Used with NEXT to establish FOR/NEXT loops. In- 
troduces the range that the loop variable will operate in 
during the execution of loop. 

FRE 


Function returns the amount of remaining user 
memory (in bytes). 

GET 

GE. 

Used mostly with disk operations to input a single byte 
of data. 

GOSUB 

GOS. 

Branch to a subroutine beginning at the specified line 
number. 

GOTO 

G. 

Unconditional branch to a specified line number. 

GRAPHICS 

GR. 

Specifies which of the eight graphics modes is to be 
used. GR.O may be used to clear screen. 

IF 


Used to cause conditional branching or to execute 
another statement on the same line (only if the first ex- 
pression is true). 

INPUT 

I. 

Causes computer to ask for input from keyboard. Ex- 
ecution continues only when |2H3S key is pressed after 
inputting data. 

INT 


Function returns the next lowest whole integer below 
the specified value. Rounding is always downward, 
even when number is negative. 

LEN 

j 

String function returns the length of the specified str- 
ing in bytes or characters (1 byte contains 1 character). 
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RESERVED BRIEF SUMMARY 


WORD: 

ABBREVIATION: 

OF BASIC STATEMENT 

LET 

LE. 

Assigns a value to a specific variable name. LET is op- 
tional in Atari BASIC, and may be simply omitted. 

LIST 

L. 

Display or otherwise output the program list. 

LOAD 

LO. 

Input from disk, etc. into the computer. 

LOCATE 

LOC. 

Graphics: Stores, in a specified variable, the value that 
controls a specified graphics point. 

LOG 


Function returns the natural logarithm of a number. 

LPRINT 

LP. 

Command to line printer to print the specified message. 

NEW 


Erases all contents of user RAM. 

NEXT 

N. 

Causes a FOR/NEXT loop to terminate or continue 
depending on the particular variables or expressions. 
All loops are executed at least once. 

NOT 


A “1” is returned only if the expression is NOT true. If 
it is true, a “0” is returned. 

NOTE 

NO. 

See DOS/FMS Manual.. .used only in disk operations. 

ON 


Used with GOTO or GOSUB for branching purposes. 
Multiple branches to different line numbers are possible 
depending on the value of the ON variable or expres- 
sion. 

OPEN 

O. 

Opens the specified file for input of output operations. 

OR 


Logical operator used between two expressions. If 
either one is true, a “1” is evaluated. A “0’ f results only 
if both are false. 

PADDLE 


Function returns position of the paddle game controller. 

PEEK 


Function returns decimal form of contents of specified 
memory location (RAM or ROM). 

PLOT 

PL. 

Causes a single point to be plotted at the X,Y location 
specified. 

POINT 

P. 

Used with disk operations only. 

POKE 

POK. 

Insert the specified byte into the specified memory loca- 
tion. May be used only with RAM. Don’t try to POKE 
ROM or you’ll get an error. 

POP 


Removes the loop variable from the GOSUB stack. Used 
when departure from the loop is made in other than 
normal manner. 

POSITION 

POS. 

Sets the cursor to the specified screen position. 

PRINT 

PR. or ? 

I/O command causes output from the computer to the 
specified output device. 
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RESERVED 

WORD: 


ABBREVIATION: 


BRIEF SUMMARY 
OF BASIC STATEMENT 


PTRIG 


Function returns status of the trigger button on game 
controllers. 

PUT 

PU. 

Causes output of a single byte of data from the computer 
to the specified device. 

RAD 


Specifies that information is in radians rather than 
degrees when using the trigonometric functions. 
Default is to RAD. (See DEG.) 

READ 

REA. 

Read the next items in the DATA list and assign to 
specified variables. 

REM 

R. or . 

Remarks. This statement does nothing, but comments 
may be printed within the program list for future 
reference by the programmer. Statements on a line that 
starts with REM are not executed. 

RESTORE 

RES. 

Allows DATA to be read more than once. 

RETURN 

RET. 

RETURN from subroutine to the statement immediate- 
ly following the one in which GOSUB appeared. 

RND 


Function returns a random number between 0 and 1, 
but never 1. 

RUN 

RU. 

Execute the program. Sets normal variables to 0, un- 
dims arrays and string. 

SAVE 

S. 

I/O statement causes data or program to be recorded on 
disk under filespec provided with SAVE. 

SETCOLOR 

SE. 

Store hue and luminance color data in a particular color 
register. 

SGN 


Function returns + 1 if value is positive, 0 if zero, - 1 if 
negative. 

SIN 


Function returns trigonometric sine of given value 

(DEG or RAD). 

SOUND 

SO. 

Controls register, sound pitch, distortion, and volume of 
a tone or note. 

SQR 


Function returns the square root of the specified value. 

STATUS 

ST. 

Calls status routine for specified device. 

STEP 


Used with FOR/NEXT. Determines quality to be 
skipped between each pair of loop variable values. 

STICK 


Function returns position of stick game controller. 

STRIG 


Function returns 1 if stick trigger button not pressed, 0 
if pressed. 

STOP 

STO. 

Causes execution to stop, but does not close files or turn 


off sounds. 
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RESERVED 

WORD: 


ABBREVIATION: 


BRIEF SUMMARY 
OF BASIC STATEMENT 


STR$ 


Function returns a character string equal to numeric 
value given. For example: STR$(65) returns 65 as a 
string. 

THEN 


Used with IF: If expression is true, the THEN 
statements are executed. If the expression is false, con- 
trol passes to next line. 

TO 


Used with FOR as in “FOR X = 1 TO 10”. Separates the 
loop range expressions. 

TRAP 

T. 

Takes control of program in case of an INPUT error 
and directs execution to a specified line number. 

USR 


Function returns results of a machine-language 
subroutine. 

VAL 


Function returns the equivalent numeric value of a 
string. 

XIO 

X. 

General I/O statement used with disk operations (see 
DOS/FMS Manual) and in graphics work (Fill). 
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ERROR 
CODE NO. 

2 

3 

4 

5 

6 

7 

8 

9 

10 

11 

12 

13 

14 

15 


ERROR 

MESSAGES 


ERROR CODE MESSAGE 

Memory insufficient to store the statement or the new variable name or to DIM a 
new string variable. 

Value Error: A value expected to be a positive integer is negative, a value ex- 
pected to be within a specific range is not. 

Too Many Variables: A maximum of 128 different variable names is allowed. 
(See Variable Name Limit.) 

String Length Error: Attempted to store beyond the DIMensioned string length. 

Out of Data Error: READ statement requires more data items than supplied by 
DATA statement(s). 

Number greater than 32767: Value is not a positive integer or is greater than 
32767. 

Input Statement Error: Attempted to INPUT a non-numeric value into a 
numeric variable. 

Array or String DIM Error: DIM size is greater than 32767 or an array/martix 
reference is out of the range of the dimensioned size, or the array /matrix or string 
has been already DIMensioned, or a reference has been made to an undimensioned 
array or string. 

Argument Stack Overflow: There are too many GOSUBs or too large an expres- 
sion. 

Floating Point Overflow/Underflow Error: Attempted to divide by zero or 
refer to a number larger than 1 x 10 98 or smaller than 1x10- ". 

Line Not Found: A GOSUB, GOTO, or THEN referenced a non-existent line 
number. 

No Matching FOR Statement: A NEXT was encountered without a previous 
FOR, or nested FOR/NEXT statements do not match properly. (Error is reported at 
the NEXT statement, not at FOR). 

Line Too Long Error: The statement is too complex or too long for BASIC to 
handle. 

GOSUB or FOR Line Deleted: A NEXT or RETURN statement was encountered 
and the corresponding FOR or GOSUB has been deleted since the last RUN. 
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ERROR 
CODE NO. 


ERROR CODE MESSAGE 


16 RETURN Error: A RETURN was encountered without a matching GOSUB. 

17 Garbage Error: Execution of “garbage” (bad RAM bits) was attempted. This error 
code may indicate a hardware problem, but may also be the result of faulty use of 
POKE. Try typing NEW or powering down, then re-enter the program without 
any POKE commands. 

18 Invalid String Character: String does not start with a valid character, or string 
in VAL statement is not a numeric string. 

Note: The following are INPUT/OUTPUT errors that result during the use of disk 

drives, printers, or other accessory devices. Further information is pro- 
vided with the auxiliary hardware. 

19 LOAD program Too Long: Insufficient memory remains to complete LOAD. 

20 Device Number Larger than 7 or Equal to 0. 

21 LOAD File Error: Attempted to LOAD a non-LOAD file. 

128 BREAK Abort: User hit key during I/O operation. 

129 IOCB 1 already open. 

130 Nonexistent Device specified. 

131 IOCB Write Only. READ command to a write-only device (Printer). 

132 Invalid Command: The command is invalid for this device. 

133 Device or File not Open: No OPEN specified for the device. 

134 Bad IOCB Number: Illegal device number. 

135 IOCB Read Only Error: WRITE command to a read-only device. 

136 EOF: End of File read has been reached. ( NOTE : This message may occur when 
using cassette files.) 

137 Truncated Record: Attempt to read a record longer than 256 characters. 

138 Device Timeout. Device doesn’t respond. 

139 Device NAK: Garbage at serial port or bad disk drive. 

140 Serial bus input framing error. 

141 Cursor out of range for particular mode. 

142 Serial bus data frame overrun. 

1 IOCB refers to Input/Output Control Block. The device number is the same as the IOCB number. 
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ERROR 
CODE NO. 

143 

144 

145 

146 

147 
160 
161 
162 

163 

164 

165 

166 

167 

168 

169 

170 

171 


ERROR CODE MESSAGE 

Serial bus data frame checksum error. 

Device done error (invalid “done 55 byte): Attempt to write on a write-protected 
diskette. 

Read after write compare error (disk handler) or bad screen mode handler. 
Function not implemented in handler. 

Insufficient RAM for operating selected graphics mode. 

Drive number error. 

Too many OPEN files (no sector buffer available). 

Disk full (no free sectors). 

Unrecoverable system data I/O error. 

File number mismatch: Links on disk are messed up. 

File name error. 

POINT data length error. 

File locked. 

Command invalid (special operation code). 

Directory full (64 files). 

File not found. 

POINT invalid. 
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APPENDIX C 


ATASCII 
CHARACTER SET 
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□ □ D 



135 

87 

136 

88 

137 

89 

138 

8A 

139 

8B 

140 

8C 

141 

8D 

142 

8E 

143 

8F 

144 

90 

145 

91 

146 

92 

347 

93 

148 

94 

149 

95 

150 

96 


151 

97 

152 

98 

153 

99 

154 

9A 

155 

9B 

156 

9C 

157 

9D 

158 

9E 

159 

9F 

160 

AO 

161 

A1 

162 

A2 

163 

A3 

164 

A4 

165 

A5 

166 

A6 


(EOL) 


RETURN 







167 

A7 

168 

A8 

169 

A9 

170 

AA 

171 

AB 

172 

AC 

173 

AD 

174 

AE 

175 

AF 

176 

BO 

177 

B1 

178 

B2 

179 

B3 

180 

B4 

181 

B5 

182 

B6 
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231 

E7 

232 

E8 

233 

E9 

234 

EA 

235 

EB 

236 

EC 

237 

ED 

238 

EE 

239 

EF 


240 

F0 

241 

FI 

242 

F2 

243 

F3 

244 

F4 

245 

F5 

246 

F6 

247 

F7 

248 

F8 


249 

250 

251 

252 

253 

254 

255 


F9 

FA 

FB 


FC 


FD 



(Buzzer) 


FE 



( Delete 
character) 


FF 



(Insert 

character) 


See Appendix H for a user program that performs decimal/hexadecimal conversion. 


Notes: 

1. ATASCII stands for “ATARI ASCII”. Letters and numbers have the same values as those in ASCII, but 
some of the special characters are different. 

2. Except as shown, characters from 128-255 are reverse colors of 1 to 127. 

3. Add 32 to upper case code to get lower case code for same letter. 

4. To get ATASCII code, tell computer (direct mode) to PRINT ASC (“ ”) Fill blank with letter, 

character, or number of code. Must use the quotes! 

5. On pages C-l and C-3, the normal display keycaps are shown as white sym- 
bols on a black background; on pages C-4 and C-6 inverse keycap symbols 
are shown as black on a white background. 
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APPENDIX D 


ATARI 400/800 
MEMORY MAP 



ADDRESS 

CONTENTS 

Decimal 

Hexadecimal 


65535 

57344 

FFFF 

E000 

OPERATING SYSTEM ROM 

57343 

55296 

DFFF 

D800 

FLOATING POINT ROM 

55295 

53248 

D7FF 

D000 

HARDWARE REGISTERS 

53247 

49152 

CFFF 

cooo 

NOT USED 

49151 

BFFF 

CARTRIDGE SLOT A 

40960 

A000 

(may be RAM if no A or B cartridge) 


40959 

32768 


9FFF 

8000 


CARTRIDGE SLOT B 

(may be RAM if no B cartridge) 


RAMTOP (MSB) 


32767 


7 FFF 


(7FFF if 32K system) 
DISPLAY DATA (size varies) 


31755 


7CIF 


DISPLAY LIST (size varies) 

(7C1F if 32K system, (GRAPHICS 0) 


OSMEMTOP 


FREE RAM 
(size varies) 


BASIC MEMTOP 


BASIC program, buffers, tables, run-time stack. 




(2A80 if DOS, may vary) 

.. — 1 

10880 

2A80 

OS MEMLO 1 


_ BASIC LOMEM 

10879 

9856 

2A7F 

2680 

DISK OPERATING SYSTEM (2A7F-700) 

DISK I/O BUFFERS (current DOS) 


9855 

4864 


267F 

1300 


DISK OPERATING SYSTEM RAM (current DOS) 
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ADDRESS 


CONTENTS 


Decimal Hexadecimal 


4863 

1792 

12FF 

700 

FILE MANAGEMENT SYSTEM RAM (current DOS) 

1791 

1536 

6FF 

600 

FREE RAM 

1535 

1406 

5FF 

57E 

FLOATING POINT (used by BASIC) 

1405 

1152 

57D 

480 

BASIC CARTRIDGE 

1151 

47F 

OPERATING SYSTEM RAM (47F-200) 

1021 

3FD 

CASSETTE BUFFER 

1020 

1000 

3FC 

3E8 

RESERVED 

999 

960 

3E7 

3C0 

PRINTER BUFFER 

959 

832 

3BF 1 

340 -1 

| IOCB’s 

831 

512 

33F i 

200 J 

MISCELLANEOUS OS VARIABLES 

511 

256 

IFF 

100 

HARDWARE STACK 

255 

FF 

PAGE ZERO 

FLOATING POINT (used by BASIC) 

212 

D4 


211 

210 

D3 

D2 

BASIC or CARTRIDGE PROGRAM 

209 

208 

D1 

DO 

FREE BASIC RAM 

207 

CF 

FREE BASIC AND ASSEMBLER RAM 

203 

CB 


202 

176 

CA 

B0 

FREE ASSEMBLER RAM \ 

1 BASIC 

128 

80 

ASSEMBLER ZERO PAGE j ZERO PAGE 

127 

0 

7F 

0 

OPERATING SYSTEM RAM 


As the addresses for the top of RAM, OS, and BASIC and the ends of OS and BASIC vary according to the 
amount of memory, these addresses are indicated by pointers. The pointer addresses for each are defined 
in Appendix I. 
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APPENDIX E 


DERIVED 

FUNCTIONS 


Derived Functions 


Derived Functions in Terms of Atari Functions 


Secant 
Cosecant 
Inverse Sine 
Inverse Cosine 
Inverse Secant 
Inverse Cosecant 
Inverse Cotangent 
Hyperbolic Sine 
Hyperbolic Cosine 
Hyperbolic Tangent 
Hyperbolic Secant 
Hyperbolic Cosecant 
Hyperbolic Cotangent 
Inverse Hyperbolic Sine 
Inverse Hyperbolic Cosine 
Inverse Hyperbolic Tangent 
Inverse Hyperbolic Secant 
Inverse Hyperbolic Cosecant 
Inverse Hyperbolic Cotangent 


SEC(X) = l/COS(X) 

CSC(X) = 1/SIN(X) 

ARCSIN(X) = ATN(X/SQR(-X*X + 1)) 

ARCCOS(X) = - ATN(X/SQR( - X*X + 1) + CONSTANT 

ARSEC(X) = ATN (SQR(X * X-l)) + (SGN(X-l)* CONSTANT 

ARCCSC(X) = ATN(1/SQR(X*X-1)) + (SGN(X-l)* CONSTANT 

ARCCOT(X) = ATN(X) + CONSTANT 

SINH(X) = (EXP(X)-EXP(-X))/2 

COSH(X) = (EXP(X) + EXP(-X))/2 

TANH(X) = -EXP(-X)/(EXP(X) + EXP(-X))*2 + 1 

SECH(X) = 2/(EXP(X) + EXP(-X)) 

CSCH(X) = 2/(EXP(X)-EXP(-X)) 

COTH(X) = EXP(-X)/(EXP(X)-EXP(-X))*2 + 1 
ARCSINH(X) = LOG(X + SQR(X*X + 1)) 

ARCCOSH(X) + LOG(X + SQR(X*X-1)) 

ARCTANH(X) = LOG((l + X)/(l-X))/2 
ARCSECH(X) = LOG((SQR(-X * X + 1) + l)/X) 

ARCCSCH(X) = LOG((SGN (X) * SQR(X * X + 1) + 1)/X) 
ARCCOTH(X) = LOG((X + l)/(X-l))/2 


Notes: 

1. If in RAD (default) mode, constant = 1.57079633 
If in DEG mode, constant = 90. 

2. In this chart, the variable X in parentheses represents the value or expression to be evaluated by the 
derived function. Obviously, any variable name is permissible, as long as it represents the number or 
expression to be evaluated. 
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Notes 



APPENDIX F 


PRINTED VERSIONS 
OF CONTROL CHARACTERS 


The cursor and screen cont rol ch aracters can be placed in a string in a program or used as a Direct mode 
statement by pressing the hey before entering the character from the keyboard. This causes the 
special symbols which are shown below to be displayed. (Refer to Section 1 - If-U Key.) 

SEE THIS 
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Notes 



APPENDIX G 
GLOSSARY 


Alphanumeric: 

Array: 


ATASCII: 

BASIC: 


Binary: 


Bit: 


Branch: 


Bug: 

Byte: 

Central Processing 
Unit (CPU): 


Code: 

Command: 


The alphabetic letters A-Z, the numbers 0-9, and some symbols. (No 
punctuation marks or graphics symbols). 

A list of numerical values stored in a series of memory locations 
preceded by a DIM statement. May be referred to by use of an array 
variable, and its individual elements are referred to by subscripted 
variable names. 

Stands for Atari American Standard Code for Information Inter- 
change. 

High level programming language. Acronym for Beginner’s All- 
purpose Symbolic Intruction Code. BASIC is always written using all 
capital letters. Developed by Mssrs. Kemeny and Kurtz at Dartmouth 
College in 1963. 

A number system using the base two. Thus the only possible digits 
are 0 and 1, which may be used in a computer to represent true and 
false, on and off, etc. 

Short for Binary Digit. A bit can be thought of as representing true or 
false, whether a circuit is on or off, or any other type of two- 
possibility concept. A bit is the smallest unit of data with which a 
computer can work. 

Atari BASIC executes a program in order of line numbers. This ex- 
ecution sequence can be altered by the programmer, and the pro- 
gram can be told to skip over a certain number of lines or return to a 
line earlier in the program. This contrived change in execution se- 
quence is called “branching”. 

A mistake or error usually in the program or “software”. 

Usually eight bits (enough to represent the decimal number 255 or 
11111111 in binary notation). A byte of data can be used to represent 
an ATASCII character or a number in the range of 0 to 255. 

In microcomputers such as the Atari systems, these are also called 
microprocessors or MPU. At one time, the CPU was that portion of 
any computer that controlled the memory and peripherals. Now the 
CPU or MPU is usually found on a single integrated circuit or “chip” 
(in Atari’s case a 6502 microprocessor chip). 

Instructions written in a language understood by a computer. 

An instruction to the computer that is executed immediately. A good 
example is the BASIC command RUN. (See Statement.) 
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Computer: 


Concatenation : 

Control Characters: 

CRT: 

Cursor: 

Data: 

Debug: 

Default: 

Digital; 

Diskette: 


DOS: 

Editing: 

Execute: 

Expression: 

Format: 
Hard Copy: 


Any device that can receive and then follow instructions to 
manipulate information. Both the instructions and the information 
may be varied from moment to moment. The distinction between a 
computer and a programmable calculator lies in the computer’s abili- 
ty to manipulate text as well as numbers. Most calculators can only 
handle numbers. 

The process of joining two or more strings together to form one 
longer string. 

Characters produced by holding down the key labeled gaiaa while 
simultaneously pressing another key. 

Abbreviation for “cathrode ray tube” (the tube used in a TV set). In 
practice, this is often used to describe the television receiver used to 
display computer output. Also called a “monitor”. 

A square displayed on the TV monitor that shows where the next 
typed character will be displayed. 

Information of any kind. 

The process of locating and correcting mistakes and errors ill a pro- 
gram. 

A mode or condition “assumed” by the computer until it is told to do 
something else. For example, it will “default” to screen and keyboard 
unless told to use other I/O devices. 

Information that can be represented by a collection of bits. Virtually 
all modern computers, especially microcomputers, use the digital ap- 
proach. 

A small disk. A record/playback medium like tape, but made in the 
shape of a flat disk that is placed inside a stiff envelope for protection. 
The advantage of the disk over cassette or other tape for memory 
storage is that access to any part of the disk is virtually immediate. 
The Atari 800 Personal Computer System can control up to 4 diskette 
drive peripherals simultaneously. In this manual, disk and diskette 
are used interchangeably. 

Abbreviation for “disk operating system”. The software or pro- 
grams which facilitate use of a disk-drive system. DOS is pronounced 
either “dee oh ess” or “doss”. 

Making corrections or changes in a program or data. 

To do what a command or program specifies. To RUN a program or 
portion thereof. 

A combination of variables, numbers, and operators (like +, -, etc.) 
that can be evaluated to a single quantity. The quaritity may be a 
string or a number. 

To specify the form in which something is to appear. 

Printed output as opposed to temporary TV monitor display* 
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Hardware: 


Increment: 


Initialize: 


Input: 


Interactive: 


Interface: 

IOCB 


I/O* 


K: 


Keyword: 


Language: 

Memory: 


The physical apparatus and electronics that make up a computer. 

Increase in value (usually) by adding one. Used a lot for counting (as 
in counting the number of repetitions through a loop). 

Set to an initial or starting value. In Atari BASIC, all non-array 
variables are initialized to zero when the command RUN is given. Ar- 
ray and string elements are not initialized. 

Information transfer to the computer. Output is information transfer 
away from the computer. In this manual, input and output are 
always in relation to the computer. 

A system that responds quickly to the user, usually within a second 
or two. All personal computer systems are interactive. 

The electronics used to allow two devices to communicate. 

Input/Output Control Block. A block of data in RAM that tells the 
Operating System the information it needs to know for an I/O opera- 
tion. 

Short for input/output, I/O devices include the keyboard, TV 
monitor, program recorder, printer, and disk drives. 

Stands for “kilo” meaning C£ times 1000”. Thus 1 KByte is (approx- 
imately) 1000 bytes. (Actually 1024 bytes.) Also, the device type code 
for the Keyboard. 

A word that has meaning as an instruction or command in a com- 
puter language, and thus must not be used as a variable name or at 
the beginning of a variable name. 

A set of conventions specifying how to tell a computer what to do. 

The part of a computer (usually RAM or ROM) that stores data or in- 
formation. 


Menu: 


A list of options from which the user may choose. 


Microcomputer: 

Monitor: 

Null String: 

OS: 

Output^ 

Parallel: 

Peripheral: 


A computer based on a microprocessor chip; in Atari’s case, the 6502. 
The television receiver used to display computer output. 

A string consisting of no characters whatever. 

Abbreviation for Operating System. This is actually a collection of 
programs to aid the user in controlling the computer. Pronounced 
“oh ess”. 

See I/O. 

Two or more things happening simultaneously. A parallel interface, 
for example, controls a number of distinct electrical signals at the 
same time. Opposite of serial. 

An I/O device. See I/O. 
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Pixel: 

Precedence: 

Program: 

Prompt: 

RAM: 

Random Number 
Generator: 

Reserved Word: 
ROM: 


Save: 

Screen: 

Serial: 

Software: 

Special Character: 

Statement: 


String: 

Subroutine: 

Variable: 

Window: 


Picture Element. One point on the screen display. Size depends on 
graphics mode being used. 

Rules that determine the priority in which operations are conducted, 
especially with regard to the arithmetical/logical operators. 

A sequence of instructions that describes a process. A program must 
be in the language that the particular computer can understand. 

A symbol that appears on the monitor screen that indicates the com- 
puter is ready to accept keyboard input. In Atari BASIC, this takes the 
form of the word “READY”. A “?” is also used to prompt a user to 
enter (input) information or take other appropriate action. 

Random Access Memory. The main memory in most computers. 
RAM is used to store both programs and data. 

May be hardware (as is Atari’s) or a program that provides a num- 
ber whose value is difficult to predict. Used primarily for decision- 
making in game programs, etc. 


See Keyword. 

Read Only Memory. In this type of solid-state electronic memory, in- 
formation is stored by the manufacturer and it cannot be changed by 
the user. Programs such as the BASIC interpreter and other car- 
tridges used with the Atari systems use ROM. 

To copy a program or data into some location other than RAM (for ex- 
ample, diskette or tape). 

The TV screen. In Atari BASIC, a particular I/O device codes “S:” 

The opposite of parallel. Things happening only one at a time in se- 
quence. Example: A serial interface. 

As opposed to Hardware. Refers to programs and data. 


A character that can be displayed by a computer but is neither a let- 
ter nor a numeral. The Atari graphics symbols are special characters. 
So are punctuation marks, etc. 


An instruction to the computer. See also Command. While all com- 
mands may be considered statements, all statements are certainly not 
commands. A statement contains a line number (deferred mode), a 
keyword, the value to be operated on, and the Id=4ilid51 command. 


A sequence of letters, numerals, and other characters. May be stored 
in a string variable. The string variable’s name must end with a $. 


A part of a program that can be executed by a special statement 
(GOSUB) in BASIC: This effectively gives a single statement the power 
of a whole program. The subroutine is a very powerful construct. 

A variable may be thought of as a box in which a value may be 
stored. Such values are typically numbers and strings. 

A portion of the TV display devoted to a specific purpose such as for 
graphics or text. 
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APPENDIX H 


USER 

PROGRAMS 


This appendix contains programs and routines that demonstrate the diverse 
capabilities of the Atari Personal Computer System. Included in this appendix is 
a Decimal/Hexadecimal program for those users who write programs that re- 
quire this type of conversion. 


CHECKBOOK 

BALANCER 


This is one of the “traditional” programs that every beginning computerist 
writes. It allows entry of outstanding checks and uncredited deposits as well as 
cleared checks and credited deposits. 


10 DIM A$( 30 >, MSG$< 40 >, MSG1 T( 30 ), MSG2*( 3 
0 ), MSG3$( 30 > , MSG4$( 30 ) , MSG5$( 30 > , MSGS* 3 
0) 


20 QUTSTAND=8 

30 GRAPHICS 0 : ? =? " CHECKBOOK BALAN 
CER" : ? 


40 ? "You may make corrections at any ti 
me by enter ins a nesative dollar value. 

II 


50 MSG 11= "OLD CHECK - STILL OUTSTANDING 

II 


60 MSG2$="0LD DEPOSIT — NOT CREDITED 

II 


70 MSG3f="0LD CHECK -- JUST CLEARED 

II 


80 f1SG4*="0LD DEPOSIT — JUST CREDITED 


90 MSG5$="NEW CHECK (OR SERVICE CHARGE) 


108 MSG6$="NEW DEPOSIT (OR INTEREST) 

II 

150 TRAP 150 "Enter besinnins balance 
from your checkbook”; = INPUT YOURBAL 
160 TRAP 160 : '( "Enter besinnins balance 
from your bank statement"; : INPUT BANKBAL 
165 TRAP 49080 
170 GOTO 190 

180 CLOSE #1=? "PRINTER IS NOT OPERATION 
AL " 

185 ? "PLEASE CHECK CONNECTORS." 

190 PERM=8 

26© ’? "Would you like a permanent- record 
on the printer" ; : INPUT A$ 

210 IF LEN( A$ )=8 THEN 288 
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220 IF A$<1,1>= !, N" THEN 480 
230 IF A$< 1 , 1 X >'"r"‘ THEN 288 
240 TRAP 180 

250 LPRINT ; REM TEST PRINTER 
260 PERM=1 


280 LPRINT "YOUR BEGINNING 
> YOURBAL 

290 LPRINT "BANK STATEMENT 
ANCE IS $".;BANK8AL- LPRINT 


BALANCE Is 
BEGINNING SAL 


400 TRAP 480=? 


"Choose one of the tol 


lowins : " 

418 ? "( 1 ) "ittSGlf 
415 ? "< 2 ) " ; MSG2$ 
420 ? "(3) " ; MSG3I- 
425 ? "(4) " ; MSG4S 
438 ? "(5) " ; MSG5I 
435 ? “< 6 > " ; MSG6$ 
440 ? "(7) DONE" 


498 ? 


500 INPUT N : IF N<1 OR N>7 THEN 488 
585 TRAP 48008 

510 OH N GOSUB 1 888 .. 2888 .. 3888 , 4808 , 5808 , 
6000,7800 

528 MSG$="NEW CHECKBOOK BALANCE IS 

" •• AMOUNT=YOURBAL = GOSUB 8808 

530 MSG$="NEN BANK STATEMENT BALANCE IS 

" : Af10UNT=BANK8AL : GUSUB 8008 

548 f1SG$= !i OUTSTANDING CHECKS-DEPOSITS= 

" : AMOUNT =OUT ST AND = GOSUB 8888 
545 IF PERM THEN LPRINT 
558 GOTO 408 

1000 REM OLD CHECK — STILL OUTSTANDING 
1010 MSG$=MSG1$- GOSUB 8188 
1820 OUT ST AND=OUT ST ANO+ AflG'UNT 
1038 RETURN 

2800 REM OLD DEPOSIT — STILL NOT CREDIT 

ED 

2018 MSG$=MSG2$ : GOSUB 8188 
2028 OUT STAND=OUT ST AND- AMOUNT 
2038 RETURN 

3088 REM OLD CHECK — JUST CLEARED 
3018 MSG$=MSG3$- GOSUB 8188 
3020 BANKBAL=8ANKBAL -AMOUNT 
3830 RETURN 

4800 REM OLD DEPOSIT — JUST CREDITED 
4018 MSG$=MSG4$ : GOSUB 8188 
4020 BANKBAL=BANKBAL+AMOUNT 
4030 RETURN 


5800 REM NEW CHECK (OR SERVICE CHARGE) - 
- JUST CLEARED 
5010 MSG$=MSG5T ; GOSUB 8188 
5028 YQURBAL=YGUR8AL-AMOUNT 
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5830 ? "IS HEW CHECK STILL OUTSTANDING"; 

INPUT A* 

5040 IF LEN(AT>=8 THEN 5038 

5058 IF AT(1,1X>"N" THEN 5060 

5855 BANKBAL=BANKBAL-AMOUNT 

5057 IF PERM THEN LPRINT "CHECK HAS CLEA 

RED." 

505S RETURN 

5068 IF AT<1 , 1 X >"Y" THEN 5030 
5870 OUT ST At-Cf=OUT ST AND+AMOUNT 
5075 IF PERM THEN LPRINT "CHECK IS STILL 
OUTSTANDING. " 

5080 RETURN 

6880 REM NEW DEPOSIT (OR INTEREST > — JU 
ST CREDITED 

6018 MSGT=MSG6T : GGSU6 8188 

6020 Y0URBAL=Y0UF:BAL+Af10UNT 

6830 ? "HAS YOUR NEW DEPOSIT BEEN CREDIT 

ED" ; : INPUT AT 

6840 IF LEf-K AT )=0 THEN 6838 
6850 IF AT< 1 , 1 X >"Y" THEN 6868 

6852 BANKBAL=BANKBAL+AMOUNT 

6853 IF PERM THEN LPRINT "DEPOSIT HAS BE 
EN CREDITED." 

6855 RETURN 

6068 IF AT( 1, 1 X>"N" THEN 6838 

6078 OUTSTAND=OUTSTAND-AMOUNT 

6075 IF PERM THEN LPRINT "DEPOSIT HAS NO 

T BEEN CREDITED." 

6880 RETURN 
7088 REM CONE 

7018 ? "BANK'S BALANCE MINUS (OUTSTANDIN 
G CHECKS-DEF'OSITS) SHOULD NOW EQUAL 
YOURCHECKBOQK BALANCE . " 

7020 DIF=YQURBAL-< BANKBAL-OUTSTAND > 

7838 IF DIFO0 THEN 7848 

7035 ? "IS T";BANKBAL; " THE ENDING BALAN 

CE ON YOUR BANK STATEMENT".; : INPUT AT 

7836 IF LEN< AT )=8 THEN 7835 

7837 IF AT< 1 .= 1 )="Y" THEN ? “CONGRATULATI 

ONS : YOUR CHECKBOOK BALANCES ! " : END 

7038 GOTO 7868 

7048 IF DIF>8 THEN ? "YOUR CHECKBOOK TOT 
AL IS T";DIF; " OUER YOUR BANK'S TOTAL. " 
: GOTO 7860 

7058 ? "YOUR CHECKBOOK TOTAL IS T";-OIF; 
" UNDER YOUR BANK'S TOTAL." 

7068 ? "WOULD YOU LIKE TO MAKE CORRECT 10 
NS?" 

7878 ? "REMEMBER, YOU CAN ENTER A NEGATI 
UE DOLLAR UALUE TO MAKE A CORRECTION. 

II 
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7080 ? "ENTER V OR NV INPUT AT 
7090 IF LEN<A*>=0 THEN END 
7100 IF A*< 1 , 1 >="Y" THEN RETURN 
7110 END 

7999 REM MSG PRINTING ROUTINE 

8080 ? MSG*; " *" ; AMOUNT 

8010 IF PERM=1 THEN LPRINT MSG*;" *";AMO 

UHT 

8020 RETURN 

8100 REM MSG PRINT & INPUT ROUTINE 
8110 TRAP 8110=? "ENTER AMOUNT FOR ";MSG 
*; = INPUT AMOUNT 
8120 TRAP 40800 

8130 IF F'ERM=1 THEN LPRINT MSG*;" *";AMO 
UNT 

8140 RETURN 
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BUBBLE SORT 


This program uses the string comparison operator “<= ” that orders strings ac- 
cording to the ATASCII values of the various characters. Since Atari BASIC does 
not have arrays of strings, all the strings used in this program are actually 
substrings of one large string. A bubble sort, though relatively slow if there are 
a lot of items to be stored, is easy to write, fairly short, and simpler to under- 
stand than more complex sorts. 


18 DIM B & 1 > 

28 GRAPHICS 8=? =? " STRING SO 

E T " :? .. 

38 TRAP 38 : Y "Enter max i mum steins le 

nsth" i = INPUT SLEN = SLEN1=SLEN-1 
35 IF SLENCl OR INK SLEN )<>SLEN THEN ? " 
FLEASE ENTER A POSITIVE INTEGER > 8."= GO 
TO 38 

48 TRAP 48 =? =? "E nter max i muni number of 
entries . " 

41 Y "(.Entries which are shorter than th 
e maximum will be padded with blanks.) 

fl 


42 INPUT ENTRIES 

45 IF ENTRIES<2 OR INK ENTRIES ><>ENTR I ES 
THEN ? "PLEASE ENTER A POSITIVE INTEGER 
> 1 . " ; G0T0 43 
47 TRAP 48888 

58 DIM Al< SLEN&ENTRIES ), TEMPI? SLEN ) 

68 Y : ? "Enter strinss one at a time." 

78 Y "Enter empty steins when done (Just 
hitRETURN)." 

75 ? :? "PLEASE STAND BY WHILE THE STRIN 
GS ARE BEING CLEARED. 

88 FOR 1=1 TO SLEN3ENTR1ES = Al< I I )=" " = N 
EXT I 
85 ? ■ ? 


98 1=1 

188 FOR J=1 TO ENTRIES 

118 ? "#" ;J;" V INPUT TEMPI 

128 IF LEN< TEMPI >=8 THEN ENTRIE3=J-1 : GOT 

0 198 

138 Alt I , I+SLEN1 )=TEMPI 
148 I=I+SLEN 
158 NEXT J 


198 ? :? • ? "PLEASE STAND BY WHILE THE S 
TRINGS ARE BEING SORTED. . 

208 gQSUB 1808 : REM CALL SORT RuUT I NE 
282 ? :? 

205 1=1 


218 FOR K=1 TO ENTRIES 
228 ? "#" .; K; " ";AK L I+SLEN1 ) 

225 I=I+SLEN 
230 NEXT K 

248 TRAP 380=? =? "WOULD YOU LIKE A PRIM 
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TED COPY"; : INPUT B* 

258 IF B$< 1 , 1 >="Y" THEN 480 
300 END 

400 1=1 = LPRINT ; FOR K=1 TO ENTRIES 
420 LPRINT " ”;A$< L I+SLEN1 > 

430 I=I+SLEN : NEXT K : END 

1000 REM STRING BUBBLE SORT ROUTINE 

1010 REM INPUT : A$, SLEN, ENTRIES 

1015 REM TEMPI MUST HAUE A DIMENSION OF 

SLEN. 

1920 SLEN1=SLEN-1 = MAN=SLEN*< ENTRIES-1 HI 

1040 FOR 1=1 TO MAN STEP SLEN 
1050 DON£=l 

I860 FOR K=1 TO MAN- I -SLEN 1 STEP SLEN 
1070 KSLEN1=K+SLEN1 : KSLEN=K+SL£N : KSLENSL 
EN1=KSLEN+SLEN1 

1080 IF h$( K, KSLEN 1 K=A$( KSLEN , KSLENSLEN 
1) THEN GOTO 1110 
1890 DONE=0 

1 100 TEMP$=A$( K, KSLEN 1 ) = Af( K, KSLEN 1 )=Af( 
KSLEN/ KSLENSLEN 1 ) = A$( KSLEN.. KSLENSLEN 1 )=T 
EMF'I 

1110 NENT K 

1120 IF DONE THEN RETURN 
1130 NENT I 
1140 RETURN 



TEXf M3DDES 
CHARACTER 
PRINT 


This program prints *?he Atari characters in their default colors for text modes 
0, 1, and 3. In entering this program, remember that the clear screen symbol 
“V is printed as “ } 


1 DIM A$< 1 > 

5 ? -REM CLEAR SCREEN 

18 ? "GRAPHICS 8 i 1, AND £ (TEXT MOOES)" 

28 ? "DEMONSTRATION. " 

30 ? "DISPLAYS CHARACTER SETS FOR EACH M 
ODE." 

60 WAiT=1000 = REM SUBROUTINE LINE NUMBER 
70 CHBAS=756 : REM CHARACTER BASE ADDRESS 
80 UPPER-224 : REM DEFAULT FOR CHBAS 
5© LOWER-226 = REM LOWER CASE LETTERS & GR- 
APHICS 

95 GGSUB WAIT 

100 FOR L=0 TO 2 

m REM USE E = FOR GRAPHICS 8 

115 IF L=8 THEN OPEN #1 , S, 8, "E = " = GOTO 11 

© 

KJ 

116 REM USE S = FOR GRAPHICS 1 AND 2 

117 OPEN #1,§,8,"S=" 

118 Graphics l 

129 PRINT "GRAPHICS ";L 

130 FOR -j— 0 TO 7 = REM 8 LINES 

148 FOR 1=8 TO 31= REM 32 CHARS/LINE 
150 K=32£J+I 

155 REM DON'T DISPLAY "CLEAR SCREEN" OR 
"RETURN" 

160 IF K=ASC< > OR K=155 THEN 188 
165 IF L=0 THEN PUT #1,ASC<" " ) = REM ESCA 

PE 

178 PUT #LK = REM DISPLAY CHARS 
180 NEXT I 

198 PRINT #1;" " = REM E® OF LINE 
200 IF L<>2 OR J< >3 THEN 248 
218 REM SCREEN FULL 
220 GOSUB WAIT 

230 PRINT #1; =REM CLEAR SCREEN 
248 NEXT J 
25@ GOSUB WAIT 

265 PRINT "LOWER CASE AND GRAPHICS" 

278 IF L< >8 THEN POKE CHBAS.- LOWER = GOSUB 
WAIT 

275 CLOSE #1 

288 NEXT L 

308 GRAPHICS 8-END 

1008 REM WAIT FOR "RETURN" 

1018 PRINT "HIT RETURN TO CONTINUE"; 

1028 INPUT AT 
1038 RETURN 
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LIGHT SHOW 


This program demonstrates another aspect of Atari graphics. It uses graphics 
mode 7 for high resolution and the PLOT and DRAWTO statements to draw the 
lines. In line 20, the title will be more effective if it is entered in inverse video 
(use the Atari logo key). 

10 FOR ST=1 TO 8 : GRAPHICS 7 
15 POKE 732, 1 

20 ? : ? " Atari's Special Lisht Show 
" = SETCOLOR 2,8,0 


30 

SETCOLOR 1 , 2&ST 

,8= COLOR 2 


40 

FOR DR=0 TO 80 

STEP ST 


50 

PLOT 0,0= DRAWTO 

100, OR 


60 

NEXT DR = FOR H=1 

TO 800= NEXT 

H=NEXT 

70 

FOR N=1 TO 2000 

= NEXT N=G0TQ 

10 
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UNITED STATES 
FLAG 


This program involves switching colors to set up the stripes. It uses graphics 
mode 7 plus 16 so that the display appears as a full-screen. Note the cor- 
respondence of the COLOR statements with the SETCOLOR statements. For fun 
and experimentation purposes, add a SOUND statement and use a READ/DATA 
combination to add “The Star Spangled Banner” after line 470. (Refer to Section 
10 .) 


10 REM DRAW THE UNITED STATES FLAG 
20 REM HIGH RESOLUTION 4-COLOR GRAPHICS, 
NO TEXT WINDOW 
30 GRAPHICS 7+16 

40 REM SETCOLOR 0 CORRESPONDS TO COLOR 1 


50 SETCOLOR 8,4,4=RED=1 
60 REM SETCOLOR 1 CORRESPONDS 


TO Cl 


70 SETCOLOR 1,0, 14 ; WHITE-2 

80 REM SETCOLOR 2 CORRESPONDS TO COLOR 3 


90 BLUE=3 : REM DEFAULTS TO BLUE 
108 REM DRAW 13 RED & WHITE STRIPES 


118 

C=RED 



120 

FOR 1=0 TO 12 



130 

COLOR C 



140 

REM EACH STRIPE HAS SI 

EUERAL 

HORIZ 

AL LINES 



150 

FOR J=8 TO 6 



160 

PLOT 8, IS7+J 



170 

DRAWTO 159,I*7+J 



180 

NEXT J 



190 

REM SWITCH COLORS 



200 

C=C+MF OWHITE THEN 

C=RED 


210 

NEXT I 



300 

REM DRAW BLUE RECTANQ 

-E 


310 

COLOR BLUE 



320 

FOR 1=8 TO 48 



330 

PLOT 0,1 



340 

DRAWTO 79, I 



358 

NEXT I 



360 

REM DRAW 9 ROWS OF WH! 

[ iE 'a j HKb 

370 

COLOR WHITE 



380 

K=0 : RBI START WITH ROi 

•j OF b 

STARS 

390 

FOR 1=0 TO 8 



395 

Y=4+IS5 



400 

FOR J=8 TO 4= REM 5 STARS IN 

A ROW 

410 

X=K+5+ 1 4 : GOSUB 1 880 



420 

NEXT J 



430 

IF K< >0 THEN K=8 : GOTO 

478 


448 

REM ADD 6TH STAR EUER' 

OTHER 

LINE 

450 

X=5+5$14 : GOSUB 1088 



460 

K=7 



470 

NEXT I 



500 

REM IF KEY HIT THEN SI 

fOP 
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510 IF PEEK< 764 >=255 THEN 518 

515 REM OPEN TEXT WINDOW WITHOUT CLEAR I 

G SCREEN 

528 GRAPHICS 7+32 

525 REM CHANGE COLORS BACK 

538 SET COLOR 8 > 4 ; 4 : SE T CULuR 1 .• 8 > 14 

550 STOP 

1000 REM DRAW 1 STAR CENTERED AT X,Y 
1010 PLOT X-LY*DRAWTO X+LY 
1020 PLOT X/Y-l : PLOT X/Y+l 
1038 RETURN 
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SEAGULL OVER 
OCEAN 


This program combines graphics and sounds. The sounds are not “pure” 
sounds, but simulate the roar of the ocean and the gull’s “tweet”. The graphics 
symbols used to simulate the gull could not be printed on the line printer. Enter 
the following characters in line 20. 


20 BIRD$ = “ V — ” 


To get these symbols, use BJ2J G, RH1 F, QJ3 R, QE9 R. 


10 DIM BIRD* 4) 

20 BIRD$=" 

30 FLAG* 1 : ROW* 1 0 = COL* 1 0 
40 GRAPHICS 1 : POKE 756.. 226 : POKE 752,1 
50 SET COLOR 8, 8 , 8 : SETCOLOR 1,8,14 
60 PRINT #6.; " the ocean" 

70 R=INT(RND(8)*11) 

80 POSITION 17,17 

90 FOR T=0 TO 10 

100 SOUND 0,T,8,4 

110 FOR A=1 TO 50= NEXT A 

120 IF RND<8»8.8 THEN FOR 0= 1 9 TO 5 STE 

P -1 •• SOUND 1 , 8, 18, 1 NT < RHOC 8 >$10 > = NEXT 0 = 

SOUND 1,8, 8,8 

138 GOSUB 288 

148 NEXT T 

150 FOR T*18 TO 0 STEP -1 

168 SOUND 0,T,8,4 

170 FOR h=1 TO 50= NEXT A 

175 IF RN0( 8 »0 . 8 THEN FOR 0=18 TO 5 STE 

P -1 = SOUND 1 , D, 18, 8 : NEXT 0 = SOUND 1 , 0, 8, 8 

180 FOR H*1 TO 18: NEXT H 

185 GOSUB 288 

198 NEXT T 

195 GOTO 78 

200 GOSUB 380 

218 POSITION uOL,ROW 

228 PR I NT #6 ; B I RDf( FLAG , FLAG+ 1 > 

238 FLAG=FLAG+2 : IF FLAG=5 THEN FLAG=1 
240 RETURN 

380 IF RND(8»8.5 THEN RETURN 
318 F’OS I T I UN l Ol , RUN 
320 PRINT #6.; " " 

338 A= I NT ( RND( 8 >$3 >- 1 

348 B= I NT ( RNDv 8 >$3 > - 1 

358 ROW=ROM+A 

368 IF R0W=8 THEN R0W=1 

370 IF R0W=28 THEN R0W*19 

388 L'OL=ijuL+B 

398 IF COL=0 THEN C0L*1 

408 IF C0L>18 THEN C0L=18 

410 RETURN 
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VIDEO 

GRAFFITTI 


This program requires a Joystick Controller for each player. Each joystick has 
one color associated with it. By maneuvering the joystick, different patterns are 
created on the screen. Note the use of the STICK and STRIG commands. 


1 GRAPHICS 0 

2 ? "UIDEO GRAFFITI" 

5 REM XfcY ARRAYS HOLD COORDINATES 

6 REM FOR UP TO 4 PLAYERS' POSITIONS. 

7 REM COLR ARRAY HOLDS COLORS. 

10 DIM ATC 1 ), X< 3 ), Y< 3 ), C0LR( 3 ) 

128 ? "USE JOYSTICKS TO DRAW PICTURES" 

129 ? "PRESS BUTTONS TO CHANGE COLORS" 

130 ? "INITIAL COLORS : " 

131 ? "JOYSTICK 1 IS RED" 

132 ? "JOYSTICK 2 IS WHITE" 

133 ? "JOYSTICK 3 IS BLUE" 

134 ? "JOYSTICK 4 IS BLACK ( BACKGROUND )" 

135 ? "BLACK LOCATION IS INDICATED BY A 
BRIEFFLASH OF RED." 

136 ? "IN GRAPHICS 8, JOYSTICKS 1 AND 3 
ARE WHITE AND 4 IS BLUE." 

138 PRINT "HOW MANY PLAYERS (1-4)"; 

139 INPUT AT • IF L£N( AT>=8 THEN AT="1" 

140 JOYMhX=UAL< AT >-l 

145 IF JOYMAX<0 OR JGYMAX>=4 THEN 138 
147 PRINT "GRAPHICS 3 (48X24), 5 (89X48) 

II 

158 PRINT "7 (169X96), OR 8 (329X192)”; 

152 INPUT AT: IF L£N( AT >=8 THEN AT="3" 

153 A=UAL( AT ) 

154 IF A=3 THEN XMAX=49 : YMAX=24 : GOTO 159 

155 IF A=5 THEN XMAX=88 : YMAX=48 : GOTO 159 


156 IF A=7 THEN XMAX=160= YMAX=96:Q0T0 15 

9 

157 IF A=8 THEN XMAX=328 : YMAX= 192= GOTO 1 

59 

158 GOTO 147 : REM A NOT UAL ID 

159 GRAPHICS A+16 

160 FOR 1=8 TO JGYMAX : X( I )=XMAX/2+I : Y( I ) 
=YMAX/2+IN€XT I : REM START NEAR CENTER 0 
F SCREEN 

161 IF A 08 THEN 166 

162 FOR 1=0 TO 2 : COLR( I )=1 ; NEXT I 

163 SETCOLOR 1,9, 14= REM LT. BLUE 

165 GOTO 189 

166 FOR 1=0 TO 2=C0LR( I )=!+!= NEXT I 

167 SETCOLOR 8, 4, 6 = REM RED 

168 SETCOLOR 1,0, 14 -REM WHITE 
189 C0LR(3)=8 

295 FOR J=0 TO 3 
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300 

FOR 1=8 TO JOYMAK 

: REM 

CHECK 

JOYSTICK 

305 

REM CHECK 

TRIGGER 




310 

IF STRIG< 

I) THEN 

32 1 



311 

IF AOS THEN 328 




312 

COLRC I >=C 

OLRC I )+l 

■■ IF C 

OLRC I : 

■=2 THEN 

COLR< I )=8 : REM 

2-COLOR 

MODE 



— i j — t 

ill 

GOTO 321 





320 

COLRC I )=C 

OLRC I )+! 

= IF C 

OLRC i : 

*=4 THEN 


COLRC I >=8 : REM 4-COLOR MODE 


321 

IF J >0 THEN COLOR COLRC I 

ijijT U 

325 

322 

IF COLRC I >=8 THEN COLOR 1 : 

GOTO 

325 

323 

COLOR 8 : REM BLINK CURRENT 

SQUAB 

:£ ON 

AND 

OFF 



325 

PLOT MCI), YCI) 



338 

JOY I N=ST I CKC I > : REM READ JO 

VST If 

:K 

348 

IF J0YIN=15 THEN 538 : REM NO MOl 

SEMENT 

342 

COLOR COLRC I > : REM MAKE SURE COL 

.OR IS 

ON 




344 

PLOT NCIOYCI) 



350 

IF J0YIN>=8 THEN 398 



368 

XC I >=XC I >+l = REM MOUE RIGHT 


365 

REM IF OUT OF RANGE THEN U 

iRrPhRuUHD 

378 

IF XC I »=X MAX THEN XC I )=8 



380 

GOTO 438 



398 

IF JOY IN >=12 THEN 438 



400 

XC I >=XC I >-l : REM MOUE LEFT 



410 

IF XCIK8 THEN XCI>=XMAX-1 



430 

IF JOYIH< >5 AND JUYIrK/9 hHO JL 

r/iN<> 

13 THEN 470 



448 

YC I >=Y< I >+l : IF YC I »=YMAX 

THEN 

YC I )= 

0 : REM MOUE DOWN 



468 

GOTO 580 



470 

I F JOY I N< > b hHO JUY I > 1 J 

t ji—, 

HriU 

iOYIN'C 

>14 

THEN 508 



480 

YC I )=YC I >-l = IF YC I >C 0 THEN 

Yt I J 

‘=YHhX 

-1 : REM MOUE UP 



588 

PLOT XCI>,YCI> 



530 

NEXT I 



535 

NEXT J 



540 

GOTO 295 
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KEYBOARD 

CONTROLLER 


This program alters registers on a chip called a PIA. To set these back to the 
default values in order to do further I/O, hit or POKE PACTL,60. If 

this program is to be loaded from disk, use LOAD, not RUN and wait for the 
busy light on the disk drive to go out. Do not execute the program before this 
light goes out, otherwise the disk will continue to spin. 


1 GRAPHICS 8 

5 PRINT = PRINT " KEYBOARD CONTROLLER 

DEMO" 

10 DIM R0W< 3 >, If< 13 >, BUTTON* 1 > 

30 GOSUB 6080 
40 FOR CNT=1 TO 4 

60 POSITION 2,CNT*2+5= PRINT "CONTROLLER 
# " ; CNT ; " = " ; 

70 NEXT CNT 

80 FOR CNT=1 TO 4 : GOSUB 7888= POSITION 19 
,CNT+CNT+5= PRINT BUTTON!; =NEHT CNT 
128 GOTO 88 

6008 REM U SET UP FOR CONTROLLERS U 
6010 PORT A=548 1 6 = PUETB=54U 1 7 = PAUTL— 540 1 o 
= PBCTL=54819 

6028 POKE PACTL, 48 = POKE PORTA, 235 : POKE P 

ACTL, 52 = POKE PORTA, 221 

6025 POKE P8CTL, 48 = POKE PORTS, 255 = POKE P 

BCTL,52=P0KE PORTS, 221 

6038 R0N< 8 )=238 = R0W< 1 >=221 = ROWC 2 >=1 87 = RO 

l*K3)=119 

6840 l$=" 12345678918#" 

6058 RETURN 

7080 REM U RETURN BUTTON! WITH CHARACTE 
R FOR BUTTON WHICH HAS BEEN PRESSED ON C 
ONTROLLER CNT (1-4). U 

7081 REM U NOTE = A 1 WILL BE RETURNED I 
F NO CONTROLLER IS CONNECTED. U 

7082 REM U A SPACE WILL BE RETURNED IF 
THE CONTROLLER IS CONNECTED BUT NO KEY H 
AS BEEN PRESSED. » 

7883 P0RT=P0RTA= IF CNT >2 THEN P0RT=P0RTB 


7085 P=1 

700S PA0=CNT +UNT-L 
7018 FOR J=8 TO 3 
7020 POKE PORT , ROWC J > 

7830 FOR 1=1 TO 10= NEXT I 

7850 IF PADDLE( PAD+1 »18 THEN P=J+J+J+2= 

GOTO 709U 

7068 IF PAOBLE 1 '. PhD .’=..=• 1 8 THEN F-J+J+ J+3 = GU 
TO 7898 

7070 IF sTRIlujNT- 1 >=0 THcN J+J+4 = LU 

TO 7898 

7088 NEXT J 

7098 BUTTOW!=I!CP,P> 

7095 RETURN 
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TYPE-A-TUNE 


This program assigns musical note values to the keys on the top row of the 
keyboard. Press only one key at a time. 


KEY 


0 

9 

8 

7 

6 

5 

4 

3 

2 

1 


MUSICAL VALUE 

B 

(or A#) 

A 

Al> (or G#) 

G 

Ytt (or Gt) 

F 

E 

B k (or D #) 

D 

(or C#) 

C 


TYPE-A-TUNE 


10 DIM CHORD'! 37 >.• TUNE( 12 ) 

20 GRAPHICS 0 : ? :? " 

PROGRAM " 

25 ? :? "PRESS KEYS 1-9, 0 ,<, > TO PRODUCE 
NOTES."; 

27 ? "RELEASE ONE KEY BEFORE PRESSING TH 


f; I 


E 

NEXT . " 





28 

? "OTHE 

RWISE THE? 

::E MAY 

BE 

A DELAY. 

30 

y 

FOR X=1 

TO 37 = REF 

iD A : L- 

HORO 

( X >=A ' ME! 

40 

FOR X=1 

TO 1 2 ; REF 

iQ M : T 

UNE( 

X >=A : HEX' 

58 

OPEN #1 

,4,8, "K'" 




55 

0L0CHR= 

_ -j 




60 

A=PEEK< 

764) 'IF A= 

=25 j T 

HEN 

66 

63 

IF A=0LDCHR THEN 

108 



65 

OLDcHR- 

A 




70 

FOR X=1 

TO 12' IF 

TUNE< 

X )=A 

THEN SCI 

0, 

CHORDc X 

), 18, 8 'GOTO 188 



80 

NEXT X 





100 I=INT< 

PEEKX 53771 

D/4>' 

IF < 

1/2 )= I NT' 

2) 

THEN 68 





110 POKE 7 

64, 255 ' SOL 

jnu y.-- 

8,8, 

8 : ULDUHR' 


: G0T0 60 

20O DATA 243,230,217,204,193, 132, 173,162 
, 153, 144, 136, 128, 121 , 1 14, 183, 182, 95, 91 , 8 
5,81, 76, 72, 68, 64, 68 

218 DATA 57, 53, 58, 47,45, 42, 48, 37, 35, 33, 3 
1,29 

228 DATA 31,38,26,24,29,27,51,53,43,50,5 

4,55 


To play “Mary Had A Little Lamb” press the following keys: 

5 , 3 , 1 , 3 , 5 , 5 , 5 3 , 3 , 3 5 , 8 , 8 5 , 3 , 1 , 3 , 5 , 5 5 , 5 , 3 , 3 , 5 , 3 , 1 
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COMPUTER 

BLUES 


This program generates random musical notes to “write” some very interesting 
melodies for the programmed bass. 


1 GRAPHICS 8= 


COMPUTER BLUE 


c» • •? 

2 PTR=1 

3 THN0T=1 

5 CHORD- 1 

6 PRINT "BASS TEMPO (1=FAST)"; 

7 INPUT TEMPO 

8 GRAPHICS 2+16 : GOSUB 2888 


18 

DIM BASEC 3, 4 

) 

28 

DIM L0WC3) 


25 

DIM LI NEC 16) 


26 

DIM JAMC 3,7) 


38 

FOR X=1 TO 3 


48 

FuR Y=1 Tu 4 


58 

READ A : BASEC ) 

i i i •. 

68 

NEXT Y 


78 

NEXT X 


88 

FOR X=1 TO 3 

: READ A : LOWC X )=A 

98 

NEXT X 


95 

FOR X=1 TO 16- READ A = LINECX>=i 

9b 

FOR X=1 TO 3 


97 

FOR Y=1 TO 7 


98 

READ A : JAMC X , 

Y )=A = NEXT V ; NEXT 

100 

GOsUB 588 


110 

T=T+1 


115 

GOSUB 288 


128 

GOTO 188 


280 

REM PROCESS 

HIGH STUFF 

285 

IF RN0C8X8. 

25 THEN RETURN 

218 

IF RNDC8X8. 

5 THEN 258 


228 NT=NT+1 

238 IF NT >7 THEN NT=7 

240 GOTO 268 

258 NT=NT-1 

255 IF NT< 1 THEN NT=1 

268 SOUND 2, JAM( CHORD, NT), 18,NT*2 

288 RETURN 

588 REM PROCESS BASE STUFF 

518 IF BASS=1 THEN 788 

528 BDUR=B0UR+1 

538 IF BOUROTEMPO THEN 535 

531 BASS=i : 8DUR-8 

53-j SUUl-lli 8 , LU«C CHORD ) , 18.-4 

548 SOUND 1 , BASEC CHORD , THNOT '5 , 1 8 - 

558 RETURN 

788 SOUND 8,8, 8.. 8 

718 SuUND 1 > 8 , U > 8 

1 2'0 SOUR— 8UCK+ 1 


H-16 Appendix 



738 

IF BDURO 

1 THEN £ 

yi-J 

748 

BOUR-8 : BA 

22=9 


758 

THH0T=THH 

nf+i 


760 

IF THHDT< 

>5 THEN 

888 

i DJ 

THH0T=1 



778 

PTR=PTR+1 



788 

IF PTR=17 

THEN FT 

R=1 

798 

CHORD=LIr€(PTR) 


888 

RETURN 



1880 

DAT R 1 S'd 

144, 136 

, 144,121,103, 182 


o l 

<,96/: 

41 . 

f 4 .* 

36 

1818 

DATA 


“7 A t-f-s 
Oj lC'vl 

1828 

DATA 

>1 

i .• 

1,1,1 

1 




1838 

DATA 


,58,4' 


1,1,1 

29 


1 04a DATA 6a , 50 , 4d, 42 , 4a , 33 , 29 


1058 

288a 

2885 

2006 

2816 

2038 


r.< 
'-'i j 


■63,64,57,53,45,40 
PRINT #6= PRINT #6 : PRINT #6 
PRINT #6,' 11 Uoiriputer" 
PRINT #6 


PRINT #6.; 

return 


Blues" 


10 


i , 
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DECIMAL/ 

HEXADECIMAL 

CONVERSION 

PROGRAM 


This program can be typed in and used to convert hexadecimal numbers to 
decimal numbers and vice versa. 


HEX HUMBER CONv 


10 DIM A$< 9 X. AD$< 1 > 

20 GRAPHICS S : ? : ? " 

ERS IONS’* :? 

30 Y : Y "Enter *D* tor DEu to HEN conver 
sion.":? "Enter 'H ' for HEN to DEC conue 


rsion.": INPUT Af 
40 IF L£H( Af >=8 THEN 30 
50 IF Af="H" THEN 388 
60 IF AfO" 0" THEN; 38 
90 TRAP 93 


100 


'ENTER h DECIMAL NUMBER FROM 0 


THRuUbH y999^9S999 


110 

? "DEC:".; : INF 

'UT N 



120 

IF N<8 OR N>= 

: 1E+18 

THEN 

GOTO 188 

138 

1=9 




140 

TEMP=H ; N=INT( 

H-' 16 ) 



150 

TEMP-TEMP -NS 1 

s 



168 

IF TEMP< 18 TH 

IhH H$‘ 

f* T . T 

STRfC TEMP ) = 

0T0 

188 




170 

AfC I .. I >=CHRf< 

TEMP- 

10+ASC 

("A")) 

180 

IF N<>8 THEN 

1=1-1 

:G0T0 

148 

138 

? "HEN: " .; AfC 

1 .• 9 ) : ' 

* 


200 

GOTO 118 




308 

TRAP 388 




318 

? :? "ENTER A 

HEN I 

NUMBER 

FROM 8 THR 

UGH 

FFFFFFFF . 

if 



328 

? "HEN-- : I HP 

UT Af 



338 

N=0 




348 

FOR 1=1 TO LENCAf) 



345 

ADf=AfCI.. I): IF AD$< 

C"8" THEN 388 

35W 

IF AfCI,IX=" 

9" THEN N=N: 

SlS+UALCADf 


: GOT u 370 


355 

IF ADK "A” 

THEN 

388 

357 

IF ADf>"F" 

THEN 

388 

368 

N=H*16+ASO: 

:adi> 

tlOL 1 -. h 

370 

NEXT I 



380 

? "DEC: ";f 

i . 

i • ! 


398 

GOTO 328 



408 

END 
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APPENDIX I 


MEMORY 

LOCATIONS 


Note: Many of these locations are of primary interest to expert programmers and are included here as a 
convenience. The labels given are used by Atari programmers to make programs more readable. 



DECIMAL 

HEXADECIMAL 

LABEL 

LOCATION 

LOCATION 

APPMHI 

14,15 

DE 

RTCLOK 

18,19,20 

12,13,14 

SOUNDR 

65 

41 


77 


LMARGIN, 

RMARGIN 

82,83 

52,53 

ROWCRS 

84 

54 

COLCRS 

85,86 

55,56 

OLDROW 

90 

5A 

OLDCOL 

91,92 

5B 


93 

5C 

NEWROW 

96 

60 

NEWCOL 

97,98 

61,62 

RAMTOP 

106 

6A 

LOMEM 

128,129 

80,81 

MEMTOP 

144,145 

90,91 

STOPLN 

186,187 

BA,BB 

ERRSAV 

195 

C3 

PTABW 

201 

C9 

FRO 

212,213 

D4,D5 


COMMENTS AND DESCRIPTION 

Highest location used by BASIC (LSB, MSB) 

TV frame counter (1/60 sec.) (LSB, NSB, MSB) 

Noisy I/O Flag (0 = quiet) 

Attract Mode Flag (128 = Attract mode) 

Left, Right Margin (Defaults 2, 39) 

Current cursor row (graphics window). 

Current cursor column (graphics window). 

Previous cursor row (graphics window). 

Previous cursor column (graphics window). 

Data under cursor (graphics window unless mode 

0 ). 

Cursor row to which DRAWTO will go. 

Cursor column to which DRAWTO goes. 

Actual top of memory (number of pages). 

BASIC low memory pointer. 

BASIC top of memory pointer. 

Line number at which STOP or TRAP occurred 
(2-byte binary number). 

Error number. 

Print tab width (defaults to 10) 

Low and high bytes of value to be returned to 
BASIC from USR function. 
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DECIMAL 

HEXADECIMAL 

LABEL 

LOCATION 

LOCATION 

RADFLG 

251 

FB 

LPENH 

564 

234 

LPENV 

565 

235 

TXTROW 

656 

290 

TXTCOL 

657,658 

291,292 

COLORO 

708 

2C4 

COLOR1 

709 

2C5 

COLOR2 

710 

2C6 

COLOR3 

711 

2C7 

COLOR4 

712 

2C8 

MEMTOP 

741,742 

2E5,2E6 

MEMLO 

743,744 

2E7,2E8 

CRSINH 

752 

2F0 

CHACT 

755 

2F3 

CHBAS 

756 

2F4 

ATACHR 

763 

2FB 

CH 

764 

2FC 

FILDAT 

765 

2FD 

DSPFLG 

766 

2FE 

SSFLAG 

767 

2FF 

HATABS 

794 

31A 

IOCB 

832 

340 


1664-1791 

680-6FE 

CONSOL 

53279 

D01F 


* Future product. 


COMMENTS AND DESCRIPTIONS 

RAD/DEG flag (0 = radians, 6 = degrees). 

Light Pen* Horizontal value. 

Light Pen* Vertical value. 

Cursor row (text window) 

Cursor column (text window) 

Color Register 0 
Color Register 1 
Color Register 2 
Color Register 3 
Color Register 4 

OS top of available user memory pointer (LSB, 
MSB) 

OS low memory pointer 

Cursor inhibit (0 = cursor on, 1 = cursor off) 

Character mode register (4 = vertical reflect; 2 = 
normal; 1= blank) 

Character base register (defaults to 224) (224 = up- 
per case, 226 = lower case characters) 

Last ATASCII character. 

Last keyboard key pressed; internal code; (255 
clears character). 

Fill data for graphics Fill (XIO). 

Display Flag (1 = display control character). 

Start/ Stop flag for paging (0 = normal listing) Set by 

1 . 

Handler address table (3 bytes/handler) 

I/O control blocks (16 bytes/IOCB) 

Spare RAM 

Console switches (bit 2 = Option; bit 1 = Select; bit 
0 = Start. POKE 53279, 0 before reading. 0 = 
switch pressed.) 
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LABEL 

DECIMAL 

LOCATION 

HEXADECIMAL 

LOCATION 

PORTA 

54016 

D300 

PORTB 

54017 

D301 

PACTL 

54018 

D302 

PBCTL 

54019 

D303 

SKCTL 

53775 

D20F 


COMMENTS AND DESCRIPTIONS 

PIA Port A Controller Jack I/O ports. 

PIA Port B Initialized to hex 3C. 

Port A Control Register (on Program Recorder 52 
= ON, 60 = OFF). 

Port B control register. 

Serial Port control register. Bit 2 = 0 (last key still 
pressed). 
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NOTES 


Notes 


INDEX 


A Abbreviations, 4-5 

Commands in headings, 4 
ABS, 33 
adata, 5 
ADR, 35,63 
aexp, 4 
aop, 4 

Array, 3-4, 41 
ASC, 37 

ATASCII, 5, 40, C-l through C-6 
ATN, 34 

Audio track of cassette, 23 
avar, 4 

B BASIC, 1 

Blanks ( see Spaces) 

Booting DOS, 25 
Braces, 4 
Brackets, 4 
Branching, 

Conditional Statements, 19 
Unconditional Statements, 17 
Brightness {see Luminance) 

Bubble Sort Program, H-5 
Buzzer, 14 
Deferred Mode, F-l 
Direct Mode, 14 
BYE, 9 

C C-Scale Program, 58 

Central Input/Output Subsystem, 23 
Character 

Assigning Color to, 54 
ATASCII, C-l through C-6 
Display at specified locations, 46, 47 
Set, internal, 55 
Sizes in Text modes, 46 
Chaining Programs, 30 

Checkbook Balancer Program, H-l through H-4 
CHR$, 58 

CIO {see Central Input/Output Subsystem) 6 
CLEAR key, 6 
Clear Screen, 

Deferred mode, 5, 14, 46 
Direct mode, 6, 46 
CLOAD, 24 
CLOG, 33 
CLOSE, 27 
CLR, 43 
Codes, 

Device, 23-24 
Colons, 3, 61 
COLOR, 48 


Color 

Assigning, 54 
Changing, 50 
Default, 46, 51 
Registers, 50 
COM {see DIM) 

Computer Blues Program, H-16 
cmdno, 30 
Comma, 26, 27 
Command Strings, 1 
Commands 
BYE, 9 
CONT, 9 
END, 9 
LET, 10 
LIST, 10 
NEW, 10 
REM, 10 
RUN, 11 
STOP, 11 
Conservation, 

Memory, 61 
Constant, 2 
CONT, 9 
Controllers, 

Game, 59 
COS, 34 
CSAVE, 24 
Cursor, 9 
Graphics, 49 
Inhibit, 46 

D Decimal/Hexadecimal Conversion Program, H-18 
Default 
colors, 46 
disk drive, 24, 29 
margins in Mode 0, 46 
tab settings, 6 
Deferred mode, 5 
DEG, 35 
Devices, 23-24 
Delete line, 13 
DIM, 41 
Direct mode, 5 
Disk Drive 

Default number, 24, 29 
Requirements {see ATARI DOS Manual ) 

Disk file 

Modification of BASIC program, 31 
Display, split-screen override, 45, 47 
Distortion, 57 
DOS, 25 
DRAWTO, 48 
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E Editing, screen, 13 
Editor, Screen, 24 
END, 9 

before subroutine, 7 
End of file, 14 

Error messages, B-l through B-3 
Escape key, 5 

with Conti ol Graphics Symbols, F-l 
EXP, 33 
exp, 5 

Exponentiation symbol, 6 
Expression, 1 
Arithmetic (see aexp) 

Logical (see lexp) 

String (see sexp) 

F filename, breakdown, 27 
filespec, 5 
Usage, 26, 27 
Fill (XIO), 54 
FOR/NEXT, 15 

building arrays and matrices, 42 
with STEP, 15 
without STEP, 15 
FRE, 35 
Function, 1 
Arithmetic 
ABS, 33 
CLOG, 33 
EXP, 33 
1NT, 33 
LOG, 34 
RND, 34 
SGN, 34 
SQR, 34 
Built-in, 7 
Derived, E-l 
Library, 33 
Special Purpose, 35 
ADR, 35 
FRE, 35 
PEEK, 35 
POKE, 35 
USR, 36 

Trigonometric, 34 
ATN, 34 
COS, 34 
DEG, 35 
RAD, 35 
SIN, 35 

G Game controllers 
Keyboard, 59 
Joystick, 59 
Paddle, 59 

Video Graffitti program, H-12 through H-13 
Game controller commands 
PADDLE, 59 
PTRIG, 59 
STICK, 59 
STRIG, 60 
GET, 28, 49 

GOSUB/RETURN, 16, 21 


GOTO, 17 

with conditional branching, 17 
GRAPHICS, 45 
Graphics 
Modes, 46-47 
Statements, 48 
COLOR, 48 
DRAWTO, 49 
GET, 45 
GRAPHICS, 48 
LOCATE, 48 
PLOT, 49 
POSITION, 49 
PUT, 49 
SETCOLOR, 50 
XIO (Fill), 54 

Graphics Control Characters, 56 

H Harmony, 57 
Hexadecimal 

/Decimal Conversion Program, H-18 
Hexcode Loader program, 64 

I INPUT, 25 

Input/Output Commands, 23 
CLOAD, 24 
CLOSE, 27 
CSAVE, 24 
DATA, 28 
DOS, 25 
ENTER, 25 
GET, 28 
INPUT, 25 
LOAD, 26 
LPRINT, 26 
NOTE, 26 
OPEN, 26 
POINT, 28 
PRINT, 3, 5, 14, 26 
PUT, 28 
READ, 28 
SAVE, 29 
STATUS, 29 
XIO, 29 

Input/Output Devices 
Disk Drives (D:), 24 
Keyboard (K:), 23 
Line Printer (L:), 23 
Program Recorder (C:), 23 
RS-232 Interface (R:), 24 
Screen Editor (E:j, 24 
TV Monitor (S:), 24 
INT, 33 

Internal pointer for DATA, 21 
Input/Output Control Block, 23 
Inverse Key, 5 

Invisible graphics cursor, 48-49 
IOCB (see Input/Output Control Block) 

J Joystick Controller, 59 

K Keyboard (K:), 23 

Keyboard Controllers, 59 
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Keyboard Controller Program, H-14 
Keys 

Special Function 
ATARI, 5 
BACK SPACE, 6 
BREAK, 6 
CAPS/LOWR, 5 
CLEAR, 6 
DELETE, 6 
ESCAPE, 5 
INSERT, 6 
RETURN, 6 
SYSTEM RESET, 6 
TAB, 6 
Editing 

CTRL (Control) Key, 13 
SHIFT key, 13 
Cursor Control, 14 
Down arrow, 14 
Left arrow, 14 
Right arrow, 14 
Up arrow, 14 
Keywords 

BASIC, A-l through A-5 

L LEN, 38 

LET, 2, 3, 10 
Letters 

Capital (upper case), 3 
Lower case, 3, 47 
lexp, 4 

Light Show Program, H-8 
Line 

Format, 3 
Logical, 2 
Numbers, 3 
Physical, 2 
lineno, 5 
LIST, 10 
LOAD, 26 

Load program from cassette tape, 24 
LOCATE, 48 
LOG, 34 
Loops 
Endless, 17 
Nested, 15 
lop, 4 

LPRINT, 26 
before CSAVE, 24 
Luminance, 50 

M Mandatory # symbol, 26, 27 
Margins 

Changing, 36, 46 
Default in mode 0, 46 
Matrix, 41-42 
Variable, 4 

Memory Map, D-l through D-2 
Modes, graphics, 46, 47 
Modes, operating 
Deferred, 5 
Direct, 5 
Execute, 5 
Memo Pad, 5, 25 


Modes, text, 46 
Override split-screen, 47 
Multiple commands {see 
Command Strings) 
mvar, 4 

N NEW, 10 
Notations 
floating point, 39 
in manual, 3 

O ON/GOSUB, 20 
ON/GOTO, 20 
OPEN, 26-28 
Operators, 2 
Arithmetic, 4, 6 
Binary, 6, 7 
Logical, 4, 6 
Relational, 7 
Unary, 6 

Output devices, 23 

Oversized programs ( see Chaining Programs) 

P Paddle Controller, 59 
Parentheses, 

Usage, 7, 63 
PEEK, 35 

Peripheral devices {see Input/Output Devices) 
Pitch 

Definition, 57 
Values, 58 
Pixel, 48 

Size in modes, 47 
PLA, 63 
PLOT, 49 
POINT, 28 
POKE, 35 
POP, 20-21 
POSITION, 49 
Precedence, operator, 7 
PRINT, 3, 5, 14, 26 
Printer listing, 10 
Program continuation, 11 
Programs, 

Machine language, 67 
User, Appendix H 
with Hexcode Loader, 65, 66 
PUT, 49 

Q, Question mark as prompt, 25 
Quotation marks, 2 

R RAD, 35 

RAM (Random Access Memory), 23 
Random Access to disk file, 28 
READ, 28 
Direct mode, 28 
REM, 10 
RESTORE, 21 
RETURN Key, 6 
Return, Abnormal {see POP) 

Rollover, 

Keyboard, 8 
RND, 34 
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RS-232(R:), 24 
RTS, 63 
RUN, 11 

S SAVE, 29 

Save programs on cassette tape, 24 
Screen Display {see TV Monitor) 
Screen Editor (E:), 24 
Seagull Over Ocean Program, H-ll 
Semicolon, 28 
SETCOLOR, 50-53 
sexp, 5 
SGN, 34 
SIN, 35 
SOUND, 57 
terminating, 9, 57 
Spaces, 61 
SQR, 34 
Stack, 16 
GOSUB, 16 
Hardware, 36 
loop addresses, 16, 21 
POP, 20 
Statement, 

Program, 15 
FOR, 15 
GOSUB, 16, 21 
GOTO, 17 
IF, 18 

ON/GOSUB, 20 
ON/GOTO, 20 
POP, 20 
RESTORE, 21 
RETURN, 16 
STEP, 15 
THEN, 18 
TO, 15 
TRAP, 22 
STEP, 15 
STOP, 11 
String 

Comparison, 40 
Concatenation, 39 
Dimensioning, 37 
Functions 
ASC, 37 
CHR$, 37 
LEN, 38 
STR$, 38 
VAL, 38 

Manipulation, 39 
Sort, 40 
Splitting, 39 
Variable, 4 
STR$, 38 
Subroutine 
Definition, 16 
GOSUB, 16 
Usage, 16 
svar, 4 


Text Modes Characters Program, H-7 
Tokenized version, 3, 24 
Tone, clipped, 57 
TRAP, 22 

Type-A-Tune Program, H-15 
u Untokenized version, 3 

V var, 4 
Variable, 2 

avoiding name limit, 2 
Video Graffitti Program, H-12 
Volume control, 57 
Voice, 57 

w Window 

Graphics, 47 
Text, 47 
Wraparound, 8 

X X-coordinate, 47 
XIO, 29 
XIO (Fill). 54 

Y Y-coordinate, 47 
Z Zero 

as Dummy Variable, 30, 34 


T Terminology, 1 
Text modes, 46 
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TABLE OF MODES 
AND SCREEN FORMATS 


Gr. 

Mode 

Mode 

Type 

Horiz. 

(Columns) 

Vert. (Rows) 
Split 
Screen 

Vert. (Rows) 
Full 
Screen 

» Of 
Colors 

RAM 

Required 

(Bytes) 

0 

TEXT 

40 

- 

24 

2 

993 

1 

TEXT 

20 

20 

24 

5 

513 

2 

TEXT 

20 

10 

12 

5 

261 

3 

GRAPHICS 

40 

20 

24 

4 

273 

4 

GRAPHICS 

80 

40 

48 

2 

537 

5 

GRAPHICS 

80 

40 

48 

4 

1017 

6 

GRAPHICS 

160 

80 

96 

2 

2025 

7 

GRAPHICS 

160 

80 

96 

4 

3945 

8 

GRAPHICS 

320 

160 

192 

1/2 

7900 I 


MODE, SET COLOR, COLOR TABLE 


Default 

Colors 

Mode or 
Condition 

SETCOLOR 

(aexpl) 

Color 

Register No. 

Color 

(aexp) 

DESCRIPTION AND COMMENTS 



0 

COLOR data 



LIGHT BLUE 

MODE 0 and 

1 

actually 

Character luminance (same color as background) 

DARK BLUE 

ALL TEXT 

2 

determines 

Background 


WINDOWS 

3 

character to 

— 

BLACK 


4 

be plotted 

Border 

ORANGE 


0 

COLOR data 

Character 

LIGHT GREEN 

MODES 1 

1 

actually determines 

Character 

DARK BLUE 

and 

2 

character to be 

Character 

RED 

2 

3 

plotted 

Character 

BLACK 

(Text Modes) 

4 


Background, Border 

ORANGE 


0 

1 

Graphics point 

LIGHT GREEN 

MODES 3, 5, 

1 

2 

Graphics point 

DARK BLUE 

and 7 

2 

3 

Graphics point 


(Four-color 

3 

- 

— 

BLACK 

Modes) 

4 

0 

Graphics point (background default), Border 

ORANGE 

MODES 4 

0 

1 

Graphics point 


and 6 

1 

- 

— 


(Two-color 

2 

- 

— 


Modes) 

3 

- 

— 

BLACK 

4 

0 


Graphics point (background default), Border 

LIGHT GREEN 


0 

_ 



DARK BLUE 


1 

1 

Graphics point luminance (same color as background) 


MODE 8 

2 

0 

Graphics point (background default) 


(1 Color 

3 

- 

— 

BLACK 

2 Luminances) 

4 

- 

Border 















































CONTROL GRAPHICS KEYBOARD 










































